Example response message: HTTP/1.1 200 OK {"IdentityAuthorityURI": "IdentityAuthorityStatus": "Up", "ServerTime": 1470822001, "CoelSpecificationVersion": [1,0] } PseudonymousKey endpoint The IDA SHALL provide a PseudonymousKey end-point which provides the means to generate Pseudonymous Keys for users whose API Credentials have the Generator role. The Identity Authority MAY periodically change the mechanism used to sign the response, so the response SHOULD be passed to the Data Engine shortly generation or validation can fail. Method Request Response Status Response Response Body Content-Type Body POST None 200 (OK) application/json JSON <IdentityAuthorityURI> /PseudonymousKey Any other status None None Content of the response body JSON object: Name Value Description REQUIRED PseudonymousKey A Pseudonymous Key generated by the IDA. Yes String Time in DateTime format, indicating when TimeStamp String Yes the IDA created this response. Signature proving that the IDA created this Signature String Yes response. Status: 200: The operation was successful 401/403: The operation failed due to authentication or authorization failure. The caller SHOULD confirm its credentials and 500: Internal the caller SHOULD retry Example Example request message: POST /PseudonymousKey Example response message HTTP/1.1 200 OK { "PseudonymousKey": "00000000-0000-0000-0000-000000000000", "TimeStamp": "Signature": "SGFDXCTVIVVIFUJUVUYBKYKJHBK==" }
Example response message: HTTP/1.1 200 OK {"IdentityAuthorityURI": "IdentityAuthorityStatus": "Up", "ServerTime": 1470822001, "CoelSpecificationVersion": [1,0] } PseudonymousKey endpoint The IDA SHALL provide a PseudonymousKey end-point which provides the means to generate Pseudonymous Keys for users whose API Credentials have the Generator role. The Identity Authority MAY periodically change the mechanism used to sign the response, so the response SHOULD be passed to the Data Engine shortly generation or validation can fail. Method Request Body Response Status Response Content-Type Response Body POST <IdentityAuthorityURI> /PseudonymousKey None 200 (OK) application/json JSON Any other status None None Content of the response body JSON object: Name Value Description REQUIRED PseudonymousKey String A Pseudonymous Key generated by the IDA. Yes TimeStamp String Time in DateTime format, indicating when the IDA created this response. Yes Signature String Signature proving that the IDA created this response. Yes Status: 200: The operation was successful 401/403: The operation failed due to authentication or authorization failure. The caller SHOULD confirm its credentials and 500: Internal the caller SHOULD retry Example Example request message: POST /PseudonymousKey Example response message HTTP/1.1 200 OK { "PseudonymousKey": "00000000-0000-0000-0000-000000000000", "TimeStamp": "Signature": "SGFDXCTVIVVIFUJUVUYBKYKJHBK==" }
COEL-v1.0-cs02.docx