REST API  4.0.0
REST API for SafeNet Network HSMs
POST /auth/login/challenge

POST /auth/login/challenge

Generate a login challenge which is to be responded to by the client.

Parameters

username

A user defined by the client

Use: Required

JSON Schema:

   Object
   type: string

certificate

The client's public certificate to register with. NOTE: The certificate must be uploaded to the server before use

Use: Required

JSON Schema:

   Object
   type: string

Responses

204

Success

400

Unexpected error

Example Request

   POST
   https://1.2.3.4:8443/auth/login/challenge
   {
      "username": "admin",
      "certificate": "-----BEGIN CERTIFICATE-----\nMIIBxDCCAS2gAwIBAgIBAjANBgkqhkiG9w0BAQUFADAAMB4XDTE2MDUxNzE4NTIw\nMloXDTE3MDUxNzE4NTIwMlowUDELMAkGA1UEBhMCQ0ExDTALBgNVBAMTBFVTRVIx\nEDAOBgNVBAgTB09OVEFSSU8xEDAOBgNVBAoTB0dFTUFMVE8xDjAMBgNVBAsTBUxP\nR0lOMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC4LMSQ4800QcHahlmlk4qZ\n7fMT2B2E/K2fIF+pNWEXOqRGlSgQ4p2WNa6BCeVIi1TqwG3egkmdYbt+BMTeoRNX\nD5mySlWgoaMLDbD4UDBiVsRPcxjUrj/LKpVAPvy7tw8IS0qFGRJpxc5RxngOauVX\nVdHhPpFFxBESVmtc3P/7eQIDAQABMA0GCSqGSIb3DQEBBQUAA4GBAD8XgEiRy/yP\nsVN40n2RKolXIxuxi6tGa490PeCOrpaLHIPnbvR16L5cHBD+HVS3GK/IERok3L3L\nks/J9xY4deUgZW7XbLYEd1cgZJrs+hnspcV+SbaB/eyFcsMk0c04WcfPSOvKXa58\nCbDtktdytsH3PDZ0c5HXO2Wue438wJfd\n-----END CERTIFICATE-----/n"
   }

Example Result

{
   "nonce": "YjBlNDg0NDUtODE3NS00ZTA4LWJiNjktMDNmMjUyZWMyZDE0"
   "challenge": "nAbCojs0aaezuIFwf1cyjauXESzTS+c0eKneHR4qK3o//dsWs57yzmOQVLiaQuiPOCCj6n6TmAeTVnUq2UA5WHhb17B9Kn2RYzwMnhJ7vVBj4k/i7bASBuzxLPKTpJY26+l0GT5/lcxI1hE8mgvx97PzNBxtgHktVbY6t5Rc4ic=", "certificate": "-----BEGIN CERTIFICATE-----\nMIIDdzCCAl+gAwIBAgIJAM36QIHFQ9hRMA0GCSqGSIb3DQEBDAUAMFIxCzAJBgNV\nBAYTAkNBMRAwDgYDVQQIDAdPbnRhcmlvMQ8wDQYDVQQHDAZPdHRhd2ExEDAOBgNV\nBAoMB0dlbWFsdG8xDjAMBgNVBAMMBXB3ZHNhMB4XDTE2MDEyOTE2MTI1M1oXDTI2\nMDEyNjE2MTI1M1owUjELMAkGA1UEBhMCQ0ExEDAOBgNVBAgMB09udGFyaW8xDzAN\nBgNVBAcMBk90dGF3YTEQMA4GA1UECgwHR2VtYWx0bzEOMAwGA1UEAwwFcHdkc2Ew\nggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9Dwd2o2odfyOb7umzlT0w\naDbERElLCCZI0J5WPN9jVsy150q4+VF2uAZZiVR+aoqJ+9aLO4lV//kD0OZA/Tiu\nl4180J87Bt8qpcVr6TJtMHPtZzJh6FxZaPPTttCz0vROP9kDLLIA5z2u0y03VZ6J\nMo8KtTUglS0tQ4oGHT3EzEicSK7oZZ8/W2nlPdsTmUF1pJxtNwz2lgRW3n8DbQSs\nUxzEe5tzT3GiiMTyiDHZZuwsBrV8Nx/mlZwppCzb/rD5fsHXSin8KjlQebygf1Re\n2I68Wwouei/W/IvS7grRf7oWzG2tjuJ2rVGt6b0vFDdimIJyhZVsMWrylz50C/8X\nAgMBAAGjUDBOMB0GA1UdDgQWBBSavwoxAbz53QMRMKzq4OS9MxHy1DAfBgNVHSME\nGDAWgBSavwoxAbz53QMRMKzq4OS9MxHy1DAMBgNVHRMEBTADAQH/MA0GCSqGSIb3\nDQEBDAUAA4IBAQAltfIvu+87I4/aSiYYwrHlnA1zsBcH9/G76AM2AFlSiHGzpR4s\n7TW6ntTp3wd1LR6JbusYdBK+GJBifYVNZ8CopGn40mYe7EPTbxHInSOmLubZJA4Y\n6iTmau1qMCwDsaryi2ZvWHHRL2v9/O/MfZW1hhWvU0pXRxfo/vSHE6GEuSecPxIA\ny698d8fnbKENvwxzi0yNS74MN7pyiNAHhTFOs95woUhY/5eX+VZs0FaAeLliZlgi\n6sS19qhe+1LO5JCVEZO3BJlJbv4T6hODAZTCnvXFYRSh6m0bTPkf4eGutgXg9FIZ\n4Whfb3hrCapSaxoieS1f2fbwDjtqQDbzW/Hx\n"
}