Thêm mới CTS SmartCA

Ngày cập nhật: 17 tháng 3, 2025
Người cập nhật: VNPT eContract's team

---

Mục đích

Thêm mới CTS SmartCA cho người dùng, có thể thêm toàn bộ chứng thư số của một người dùng, hoặc thêm một chứng thư dựa vào serial cụ thể.

• Request URL: /api/users/smart-ca/add
• HTTP method: POST
• HTTP content-type: application/json
• Authorize: Bearer token
• Parameter:

Key	Type	Description
userId	int	[Bắt buộc] Id người dùng
username	string	[Bắt buộc] CCCD/HC/MST của tài khoản SmartCA
serialNumber	string	Serial chứng thư số

Mẫu request

{
    "userId": 1234,
    "userName": "08009000000",
    "serialNumber": "540101014e4653549c5a6fdcb9c89999"
}

Mẫu response body

{
    "data": {
        "id": 1234,
        "createdDate": "2021-01-06T17:06:07.2893325",
        "comId": 16,
        "code": "USER01",
        "username": "your_username",
        "name": "Nguyễn Văn A",
        "phone": "0919XXXXXX",
        "email": "email_address",
        "validFrom": "2021-12-07T09:15:00",
        "validTo": "2022-12-07T09:15:00",
        "isValid": true,
        "signConfirmationEnabled": false,
        "isAccountLocked": false,
        "accountId": "c59125a9-5fee-44e2-b0ff-b229634bf0b2",
        "signatureText": "Ký bởi: {{SubjectDN.CN}} / {{SubjectDN.O}} / {{SubjectDN.OU}} / {{SubjectDN.UID}}\r\nChức vụ: {{SubjectDN.T}}\r\nKý ngày: {{SignTime}}",
        "roles": [
            {
                "id": "29e1138e-833e-4b3a-897a-08da9c3dd633",
                "code": "Admin",
                "name": "Admin quản lý công ty",
                "description": "Tài khoản admin quản lý công ty"
            }
        ],
        "signMethod": {
            "value": 2,
            "description": "VNPT SmartCA"
        },
        "status": {
            "value": 1,
            "description": "Enabled"
        },
        "receiveOtpMethod": {
            "value": 1,
            "description": "Email"
        },
        "receiveNotificationMethod": {
            "value": 0,
            "description": "Email"
        },
        "personalCertificateId": 22105,
        "smartCaId": 19843,
        "extraValues": [
        ],
        "usedMemory": 0,
        "defaultSmartCa": {
            "id": 37666,
            "name": "Nguyễn Văn A 2026",
            "commonName": "Nguyễn Văn A",
            "uid": "08009000000",
            "validFrom": "2025-03-07T08:56:16Z",
            "validTo": "2026-03-07T08:56:16Z",
            "serialNumber": "540101014e4653549c5a6fdcb9c89999",
            "subjectDN": "UID=CCCD:08009000000,CN=Nguyễn Văn A,L=Quận 3,ST=Hồ Chí Minh,C=VN",
            "status": {
                "value": 1,
                "description": "Active"
            },
            "smartCaServiceName": "TEST_CÁ NHÂN ĐỐI TÁC",
            "smartCaSignMethod": {
                "value": 1,
                "description": "Normal"
            },
            "smartCaAccountType": {
                "value": 1,
                "description": "Personal"
            },
            "smartCaUsername": "08009000000",
            "isValid": true,
            "provider": {
                "value": 1,
                "description": "VNPT SmartCA"
            },
            "createdDate": "2025-03-17T08:56:42.4886305+07:00",
            "isBusinessSmartCaAccount": false,
            "ownerId": 6,
            "createdByUserId": 6
        },
        "userCertificates": [
            {
                "id": 37666,
                "name": "Nguyễn Văn A 2026",
                "commonName": "Nguyễn Văn A",
                "uid": "08009000000",
                "validFrom": "2025-03-07T08:56:16Z",
                "validTo": "2026-03-07T08:56:16Z",
                "serialNumber": "540101014e4653549c5a6fdcb9c89999",
                "subjectDN": "UID=CCCD:08009000000,CN=Nguyễn Văn A,L=Quận 3,ST=Hồ Chí Minh,C=VN",
                "status": {
                    "value": 1,
                    "description": "Active"
                },
                "smartCaServiceName": "TEST_CÁ NHÂN ĐỐI TÁC",
                "smartCaSignMethod": {
                    "value": 1,
                    "description": "Normal"
                },
                "smartCaAccountType": {
                    "value": 1,
                    "description": "Personal"
                },
                "smartCaUsername": "08009000000",
                "isValid": true,
                "provider": {
                    "value": 1,
                    "description": "VNPT SmartCA"
                },
                "createdDate": "2025-03-17T08:56:42.4886305+07:00",
                "isBusinessSmartCaAccount": false,
                "ownerId": 6,
                "createdByUserId": 6
            }
        ],
        "smartCaGroups": [
        ]
    },
    "success": true,
    "code": 0,
    "messages": [
        "Add SmartCA certificate successfully"
    ]
}