Utiliser le portail des développeurs

Introduction

IBM Security Verify intègre un portail développeur intégré qui vous permet, en tant que développeur autorisé dans le locataire, d'enregistrer vos applications pour l'intégration OAuth 2.0 et OpenID Connect.

Cet article décrit comment accéder au portail développeur, comment enregistrer une nouvelle application et comment gérer une application existante.

Prérequis

Votre locataire IBM Security Verify doit avoir été configuré avec l'application du portail développeur. Ceci doit être fait par un administrateur de locataire. Ce processus est décrit dans le guide de configuration Ajouter le portail développeur.

Votre compte dans IBM Security Verify doit être membre du groupe développeur. Un administrateur de locataire peut ajouter votre compte à ce groupe.

Accéder au portail développeur

Accédez au launchpad d'utilisateur final de votre locataire IBM Security Verify et recherchez la tuile du portail développeur. Celle-ci devrait être visible pour vous une fois que vous êtes membre du groupe développeurs :

Cliquez sur la tuile pour lancer le portail développeur.

Ajouter une nouvelle application

Lorsque vous accédez pour la première fois au portail développeur, vous n'avez aucune application enregistrée. Pour enregistrer votre première application, cliquez sur le bouton Add application +.

Donnez un nom à votre application. Ce nom sera affiché lorsque votre application sera affichée dans le launchpad d'utilisateur final. Vous pouvez également fournir une courte description si vous le souhaitez.

Sélectionnez le type d'octroi pour l'application.

📘

Types d'octroi disponibles

Les types d'octroi disponibles sont déterminés par l'administrateur de locataire lorsqu'il configure le portail développeur. Si le type d'octroi dont vous avez besoin n'est pas affiché, vous devrez demander à un administrateur de mettre à jour les paramètres du portail développeur.

Si affiché, entrez une valeur pour l'App URL. Il s'agit de l'URL vers laquelle les utilisateurs seront dirigés s'ils choisissent l'application depuis le launchpad d'utilisateur final.

Si affiché, entrez une valeur pour l'URI de redirection. Ceci est requis pour les types d'octroi code d'autorisation et implicite et est l'URL vers laquelle IBM Security Verify redirigera le navigateur après que l'authentification soit terminée.

Cliquez sur Register app pour terminer l'enregistrement.

Afficher les extraits de code et un exemple d'application

Une fois votre application enregistrée, vous avez la possibilité d'accéder aux extraits de code et à un exemple d'application qui sont pertinents pour le type d'octroi que vous avez sélectionné pour l'application. Pour accéder à ceux-ci, sélectionnez la tuile pour le langage/framework que vous voulez voir.

Extraits de code

L'extrait de code montre comment initialiser le SDK Verify et est pré-rempli avec votre id de locataire et avec le client_id et client_secret pour l'enregistrement d'application que vous venez de terminer. Il y a aussi un lien vers un guide étape par étape sur la façon d'utiliser le SDK dans votre propre code d'application.

Exemple d'application

Il y a un lien pour télécharger un fichier ZIP contenant un exemple d'application. Ce fichier ZIP contient un fichier d'environnement qui a été rempli avec votre id de locataire et le client_id et client_secret pour l'enregistrement d'application que vous venez de terminer.

Il y a aussi un lien vers le dépôt GitHub pour l'exemple d'application qui inclut des instructions sur l'installation et l'exécution de l'exemple d'application.

Vous pouvez revenir à cette page plus tard en sélectionnant l'option App setup sur la page My applications.

Récupérer l'id client et le secret client

Pour obtenir l'id client et le secret client qui ont été créés pour votre nouvelle application, sélectionnez-la sur l'écran My applications. Cela affichera les propriétés de l'application sur la droite de l'écran :

Vous pouvez copier-coller l'ID Client et le Secret depuis cette page.

Modifier la configuration de l'application

Une fois que vous avez des applications enregistrées via le portail développeur, vous les verrez listées lorsque vous accédez au portail développeur :

Lorsque vous cliquez sur les points à la fin de la ligne, vous verrez l'option Edit app settings que vous pouvez sélectionner pour modifier les paramètres de l'application. Cela ouvrira une page de configuration complète. En plus de mettre à jour les paramètres de protocole ici, vous pouvez également fournir une image personnalisée pour l'application qui sera utilisée sur le launchpad d'utilisateur final.