Quickstart

Set up your workspace

1. Sign in to the dashboard

   Open the dashboard and sign in with the email and password you were given. If you were invited, use the link in your invitation email to choose your password first.

2. Protect your own account
   In the dashboardAccount & Security›Two-factor authentication

   Add an authenticator app before anything else. Admin accounts are the most valuable accounts in your workspace. See Two-factor authentication.

3. Brand the sign-in page
   In the dashboardBranding

   Add your product name, logo and accent color so your users recognise where they are signing in. See Branding.

4. Invite your team
   In the dashboardUsers & Identities›Invite user

   Enter a teammate's email and pick a role: admin for people who manage settings, viewer for people who only need to look. They get an email and choose their own password. See Users and invitations.

Connect your product

1. Register your application
   In the dashboardApplications›Create application

   Give it a name and the URL your app should return to after sign-in, for example https://app.example.com/callback. Copy the client secret when it appears; it is shown once.

2. Create a secret API key for your backend
   In the dashboardAPI Keys›Generate API key

   Choose Secret key and store it in your server's secret manager.

3. Create your first user

   From your backend, create a user with the API. You can also do this from the dashboard under Users & Identities.

   Create a userCopy

   curl -X POST https://id.trustportidentity.com/api/v1/users \
     -H "Authorization: Bearer $TRUSTPORT_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "email": "ada@example.com",
       "username": "ada",
       "password": "a-long-unique-passphrase",
       "first_name": "Ada",
       "last_name": "Obi"
     }'

4. Sign them in

   Send the user's credentials to the sign-in endpoint, with your workspace ID in the header.

   Sign inCopy

   curl -X POST https://id.trustportidentity.com/api/v1/auth/login \
     -H "Content-Type: application/json" \
     -H "X-Tenant-ID: $TRUSTPORT_WORKSPACE_ID" \
     -d '{ "username": "ada@example.com", "password": "a-long-unique-passphrase" }'

   You get back an access token and a refresh token, or a two-factor challenge if the user has turned on two-factor authentication. Add sign-in to your app covers both.

5. Check the audit log
   In the dashboardAudit Logs & Compliance

   You'll see a UserCreated event and a LoginSuccess event. Every sign-in and account change in your workspace appears here.

Where to go next