Skip to main content

Protocol reference

TraffiTech speaks the standard identity protocols so your existing IdP, apps, and provisioning tools work without custom code.

Supported​

ProtocolWhat it's forLearn more
OAuth 2.0Authorization - delegated access for backend services and APIs; the substrate of OIDCOAuth 2.0
OpenID Connect (OIDC)Authentication - signing users in from SPAs, web apps, and mobile clientsOpenID Connect
SCIM 2.0User provisioning - sync users from an enterprise directory (e.g. Microsoft Entra ID)User Provisioning (SCIM)

How they relate​

OIDC, OAuth, and SCIM solve three different problems and are usually used together:

  • OAuth 2.0 gives a client an access token that represents a delegated permission ("this app is allowed to read your data").
  • OpenID Connect builds on OAuth to also answer "who is the user?" - it adds an ID token that carries user identity claims.
  • SCIM is completely separate from sign-in: it's how your IdP pushes the list of users (and their attribute changes, deactivations) into TraffiTech on a schedule.

If you only need sign-in, you need OIDC. If you also want your IdP to keep user accounts in sync, add SCIM.

Using a token against the APIs​

The access token an OAuth 2.0 flow gives you is the same token both platform APIs accept. Once you have one, see:

  • Core API (REST) - how the token is sent, and how each endpoint authorizes it against the caller's grants
  • Vehicle Data API (GraphQL) - the same token, accepted either as a header or as a token query parameter

Note that authentication and authorization are separate concerns on both APIs: a valid token establishes who you are, and every object is then checked against your grants for the owning organization. A caller with a good token can still legitimately receive 403, or an empty result.