CAcardinalapps
Authentication

🛡️ Log into a Cardinal app.

Changed on

Logs the user into a client application that is hosted (bundled web app) or served by this server.

If logging into the Guest Account, no credentials are required. If logging into a Cardinal Account, a valid Cardinal SSO token is required.

The client app <strong>must</strong> set the <code>cardinal-app</code> header for this request.

Only the capability corresponding to the application that you are trying to log into will be validated.<br /><hr /><h3>🛡️ Requires one of these Capabilities: <code>AdminApp.Login</code> <code>MusicApp.Login</code> <code>PhotosApp.Login</code> <code>CinemaApp.Login</code></h3>

post/api/v1/auth/login

Request

Headers

cardinal-app'admin' | 'music' | 'photos' | 'cinema'

Request body

userIdstring
usernamestring
passwordstring
cardinalJWTstring

Response

JWTstring required
userobject required
cloudJWTstring
cloudUserobject
refreshTokenstring
scopeobject

Changes

  • fd25cc21a89eRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 503a10ab48c2Revision changes
    • info

      endpoint added