Viewing KACLS Endpoints
Use the GET /v1/cckm/GoogleWorkspaceCSE/endpoints API to view the list of KACLS endpoints.
Syntax
curl -k '<IP>/api/v1/cckm/GoogleWorkspaceCSE/endpoints?skip=0&limit=10' -H 'Authorization: Bearer AUTHTOKEN' --compressed
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| AUTHTOKEN | string | Authorization token. |
Request Query Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | ID of the endpoint to search for a particular endpoint. |
| name | string | Name of the endpoint. |
| skip | integer | Number of records to skip. For example, if "skip":5 is specified, the first five records will not be displayed in the output. |
| limit | integer | Numbers of records to display. For example, if "limit":10 is specified, then the next 10 records (after skipping the number of records specified in the skip parameter ) will be displayed in the output. |
Example Request
curl -k 'https://127.0.0.1/api/v1/cckm/GoogleWorkspaceCSE/endpoints?skip=0&limit=10' -H 'Authorization: Bearer AUTHTOKEN' --compressed
Example Response
{
"skip": "0,",
"limit": "10,",
"total": "1,",
"resources": [
{
"issuer": [
"39a9e91b-7a95-4fbf-bf79-30930eeb1d2c",
"39a9e91b-7a95-4fbf-bf79-30930eeb1d2d"
],
"id": "39a9e91b-7a95-4fbf-bf79-30930eeb1d2c",
"uri": "kylo:kylo:cckm:auth:39a9e91b-7a95-4fbf-bf79-30930eeb1d2c",
"account": "kylo:kylo:admin:accounts:kylo",
"application": "ncryptify:gemalto:admin:apps:kylo",
"devAccount": "ncryptify:gemalto:admin:accounts:gemalto",
"createdAt": "2019-12-24T08:06:28.7135Z",
"name": "endpoint_1",
"updatedAt": "2019-12-24T08:06:28.692717Z",
"cors": [
"https://foo.example",
"https://bar.example"
],
"authorizationAud": null,
"authenticationAud": [
"122334a33qr31038dekfhfl"
],
"endpoint_url_hostname": "<KS IP>",
"endpoint_url": "https://<KS IP>/cckm/GoogleWorkspaceCSE/39a9e91b-7a95-4fbf-bf79-30930eeb1d2c",
"kekName": "GoogleWorkspaceCSE_endpoint_1_39a9e91b-7a95-4fbf-bf79-30930eeb1d2c",
"kekID": "39a9e91b7a954fbfbf7930930eeb1d2c39a9e91b7a954fbfbf7930930eeb1d2c",
"kekVersion": "0",
"meta": null,
"status": "active",
"allow_privileged_unwrap": false,
"allow_rewrap": false,
"allow_guest_access": false
}
]
}
The output shows the details of existing endpoints. Each endpoint has a unique ID, for example, "c1583936-7d03-4e2d-a0ae-3a1ae2d2e200". The endpoint ID is required when viewing, modifying, wrapping, unwrapping, and deleting the KACLS endpoint. The ID is also required when rotating encryption key of an endpoint, and viewing and updating the KACLS endpoint perimeter.
Response Codes
| Response Code | Description |
|---|---|
| 2xx | Success |
| 4xx | Client errors |
Refer to HTTP status codes for details.
