certificate profile - Flexible Security Service API References (1.3.0)
Download OpenAPI specification:Download
manage certificate profiles
Get Certificate Profiles
Get certificate profile resources.
Authorizations:
query Parameters
| id | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ The ID of the resource. |
| name | string ^[a-zA-Z0-9-_]{1,255}$ A name of the resource. |
| configType | string Enum: "MFA" "MgmtAccess" Functional labels related to profiles. |
| owner | string Enum: "user" "system" Who is the owner of the certificate. |
| crlEnabled | boolean Enable Certificate Revocation List (CRL) or not. |
| tenantId | string ^[a-fA-F0-9]{32}$ ID of the tenant to which the resource belongs. |
| fraGroupId | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ ID of the service group to which the resource belongs. |
Responses
200
OK
400
Bad Request
401
Unauthorized
500
Internal Server Error
503
Service Unavailable
get/v1/certificate-profiles
https://api.ntt.com/fsec-ers/v1/certificate-profiles
Response samples
- 200
- 400
- 401
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfiles": [
- {
- "id": "12345678-1234-1234-1234-1234567890a1",
- "name": "certificate-profile-a",
- "description": "certificate-profile-a",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c1",
- "name": "certificate1",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": true,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z"
}, - {
- "id": "12345678-1234-1234-1234-1234567890a2",
- "name": "certificate-profile-b",
- "description": "certificate-profile-b",
- "configType": "MgmtAccess",
- "owner": "system",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c3",
- "name": "certificate3",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": false,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b2",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z"
}
]
}Create Certificate Profile
Create certificate profiles resource.
Authorizations:
Request Body schema: application/json
| certificateProfile required | object (CertificateProfileCreateRequest) |
Responses
202
OK
400
Bad Request
401
Unauthorized
409
Conflict
500
Internal Server Error
503
Service Unavailable
post/v1/certificate-profiles
https://api.ntt.com/fsec-ers/v1/certificate-profiles
Request samples
- Payload
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "name": "certificate-profile-a",
- "description": "certificate-profile-a",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "name": "certificate1",
- "dataEncoding": "base64",
- "data": "<encoded_data>"
}, - {
- "name": "certificate2",
- "dataEncoding": "base64",
- "data": "<encoded_data>"
}
], - "crlEnabled": true,
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1"
}
}Response samples
- 202
- 400
- 401
- 409
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "id": "12345678-1234-1234-1234-1234567890a1",
- "name": "certificate-profile-a",
- "description": "certificate-profile-a",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c1",
- "name": "certificate1",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": true,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z",
- "operationId": "12345678-1234-1234-1234-1234567890b1"
}
}Get Certificate Profile
Get certificate profile resource.
Authorizations:
path Parameters
| certificate_profile_id required | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ |
Responses
200
OK
400
Bad Request
401
Unauthorized
404
Not Found
500
Internal Server Error
503
Service Unavailable
get/v1/certificate-profiles/{certificate_profile_id}
https://api.ntt.com/fsec-ers/v1/certificate-profiles/{certificate_profile_id}
Response samples
- 200
- 400
- 401
- 404
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "id": "12345678-1234-1234-1234-1234567890a1",
- "name": "certificate-profile-a",
- "description": "certificate-profile-a",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c1",
- "name": "certificate1",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": true,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z"
}
}Update Certificate Profile
Update certificate profile resource.
Authorizations:
path Parameters
| certificate_profile_id required | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ |
Request Body schema: application/json
| certificateProfile required | object (CertificateProfileUpdateRequest) |
Responses
202
OK
400
Bad Request
401
Unauthorized
404
Not Found
409
Conflict
500
Internal Server Error
503
Service Unavailable
patch/v1/certificate-profiles/{certificate_profile_id}
https://api.ntt.com/fsec-ers/v1/certificate-profiles/{certificate_profile_id}
Request samples
- Payload
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "description": "certificate-profile-b",
- "certificates": [
- {
- "name": "certificate3",
- "dataEncoding": "base64",
- "data": "<encoded_data>"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2"
}
], - "crlEnabled": true
}
}Response samples
- 202
- 400
- 401
- 404
- 409
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "id": "12345678-1234-1234-1234-1234567890a1",
- "name": "certificate-profile-b",
- "description": "certificate-profile-b",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c1",
- "name": "certificate1",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": true,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z",
- "operationId": "12345678-1234-1234-1234-1234567890b1"
}
}Delete Certificate Profile
Delete certificate profile resource.
Authorizations:
path Parameters
| certificate_profile_id required | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ |
Responses
202
OK
400
Bad Request
401
Unauthorized
404
Not Found
409
Conflict
500
Internal Server Error
503
Service Unavailable
delete/v1/certificate-profiles/{certificate_profile_id}
https://api.ntt.com/fsec-ers/v1/certificate-profiles/{certificate_profile_id}
Response samples
- 202
- 400
- 401
- 404
- 409
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "id": "12345678-1234-1234-1234-1234567890a1",
- "name": "certificate-profile-a",
- "description": "certificate-profile-a",
- "configType": "MFA",
- "owner": "user",
- "certificates": [
- {
- "id": "12345678-1234-1234-1234-1234567890c1",
- "name": "certificate1",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}, - {
- "id": "12345678-1234-1234-1234-1234567890c2",
- "name": "certificate2",
- "expiresAt": "2033-06-01T06:00:00.000Z",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
], - "crlEnabled": true,
- "operationStatus": "COMPLETE",
- "fraGroupId": "12345678-1234-1234-1234-1234567890b1",
- "serviceGroupId": "12345678-1234-1234-1234-1234567890c1",
- "tenantId": "1234567890abcdef1234567890abcdef",
- "updatedAt": "2022-06-01T06:00:00.000Z",
- "createdAt": "2022-06-01T00:00:00.000Z",
- "operationId": "12345678-1234-1234-1234-1234567890b1"
}
}Export Certificate file
Export certificate file only when owner is system.
Authorizations:
path Parameters
| certificate_profile_id required | string ^[a-fA-F0-9]{8}(-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}$ |
Request Body schema: application/json
| certificateProfile required | object (CertificateProfileExportRequest) |
Responses
200
OK
400
Bad Request
401
Unauthorized
404
Not Found
500
Internal Server Error
503
Service Unavailable
post/v1/certificate-profiles/{certificate_profile_id}/export
https://api.ntt.com/fsec-ers/v1/certificate-profiles/{certificate_profile_id}/export
Request samples
- Payload
Content type
application/json
Copy
Expand all Collapse all {- "certificateProfile": {
- "passphrase": "Passphrase1",
- "certificateId": "12345678-1234-1234-1234-1234567890c1"
}
}Response samples
- 200
- 400
- 401
- 404
- 500
- 503
Content type
application/json
Copy
Expand all Collapse all {- "certificateFile": {
- "value": "<encoded_data>",
- "dataEncoding": "base64",
- "checksum": "e1ac5446165bc0cf31e41056bceec6bd719284175777af0a6bb10bd2cf4e9e9d"
}
}