Create a username/password for a customer

Customers can then get a JWT with these credentials and access their profile, wallets, cards etc. This is necessary when tenants want to give their customers direct access to the APIs or for customers using companion Apps. If using PKI, to generate a public/private key combination use openssl: openssl req -nodes -x509 -sha256 -newkey rsa:4096 -keyout "PrivateKey.key" -out "PublicKey.crt" -days 99999 Then extract the base64 public key from the certificate as follows: openssl x509 -in PublicKey.crt -pubkey -noout | grep -v "-----" | base64 -d| base64 -w0 For generating a special CAP (card access password) for a customer to view unmasked card details but without creating a proper identity on Eclipse, one can create an identity with identity "CAP".If this is done with a tenant JWT and no password then a random password is generated by Eclipse and SMS'd to the customers phone on profile. If CAP is passed with no JWT and no password then an SMS with an OTP is sent to the customer. This API can then be called passing CAP, a password to set and the OTP (again with no JWT).Note that a CAP cannot be used for getting a JWT. It can only be used to get card details. To create a WebAuthN identity, just pass an identity. Then proceed with getting a login-challenge to initiate the WebAuthN registration process.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required
int64
required
Body Params

A username/password and optional public key for getting a valid JWT. A public key is recommended for system identities and adds an extra layer of security as the associated private key would never leave your servers and is hence impermiable to MITM attacks being used to get auth credentials as unlike a password, the private key would never be sent to Eclipse. To generate a public/private key combination use openssl: openssl req -nodes -x509 -sha256 -newkey rsa:4096 -keyout PrivateKey.key -out PublicKey.crt -days 99999 Then extract the base64 public key from the certificate as follows: openssl x509 -in PublicKey.crt -pubkey -noout | grep -v ----- | base64 -d| base64 -w0 That is the data you send as the base64EncodedPublicKey.

date-time

Optional. ISO 8601 date/time of when the identity cannot be used after. Changing password before authLockedAfter would set authLockedAfter to null and effectively make the identity usable any time

string
length between 100 and 2000

An optional PKI RSA public key for added security. If a public key is provided then the PKI login-challenges endpoint should be used to get a challenge to respond to as part of the login

date-time

Optional. ISO 8601 date/time of when the current password expires and a password reset must be done

string
required
length between 3 and 40

Identity/username for authentication

string
length between 3 and 20

An OTP to use to prove the presence of the customer if an identity is created without passing a JWT. Typically used for web UIs needing to add a card access password with a specific password

string
length between 3 and 80

Can be pre-hashed with BCRYPT or passed as clear text in which case Eclipse will hash it

boolean

Whether this identity will require a time base one time password when authenticating. If true, the response will include a QRCode which can be scanned with any RFC 6238 compliant App (E.g. Google Authenticator)

Responses

400

Bad Request

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json