Authentification

L'API BlackBerry AtHoc V2 utilise une authentification et une autorisation conformes à OAuth2. Pour appeler l'API, le client doit d'abord obtenir un jeton d'accès. Chaque organisation possède un jeton d'accès. Vous devrez demander un jeton d'accès pour chaque organisation individuelle que vous appelez. L'étape d'authentification renvoie un jeton d'accès qui sera utilisé lors de l'appel des API.

Le jeton d'accès n'est utile que si l'utilisateur possède un rôle d'opérateur requis pour accéder au module d'API spécifique. Par exemple, le rôle de gestionnaire d'utilisateurs est requis pour la synchronisation des utilisateurs. Pour plus d'informations, reportez-vous à Rôles requis pour l\'accès à l\'API.

Le paramètre acr_values doit contenir le code d'organisation dans une paire clé-valeur avec Key=tenant (par exemple, acr_values=tenant:<OrgCode>) où <OrgCode> est le code d'organisation de l'organisation pour laquelle vous souhaitez accéder à l'API.

L'étendue doit être une chaîne délimitée par des espaces des ressources auxquelles vous souhaitez accéder. Si vous avez également besoin d'un accès à long terme à l'API, vous pouvez demander un jeton d'actualisation avec l'étendue offline_access. Par exemple, openid profile athoc.iws.web.api offline_access.

Selon votre application et vos exigences de sécurité, vous pouvez obtenir un jeton d'accès à partir de l'un des types d'octroi pris en charge suivants :

  • Octroi de mot de passe
  • Octroi de code d'autorisation
  • Octroi implicite
  • Octroi de changement d'organisation
  • Octroi de jeton d'actualisation