Utiliser des identifiants fédérés sur le portail des développeurs

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X. en savoir plus

La connexion fédérée est le processus par lequel vous utilisez les informations d'identification d'un système de gestion des identités, appelé système d'enregistrement, pour vous connecter à un autre système. Par exemple, vous pouvez utiliser vos identifiants Google ou Twitter pour vous connecter au portail des développeurs Apigee. L'avantage de la connexion fédérée est que le système auquel vous vous connectez ne voit jamais le mot de passe associé à vos identifiants. Cela signifie que vos mots de passe n'ont pas besoin d'être copiés sur d'autres systèmes.

Le portail des services pour les développeurs accepte la connexion fédérée à l'aide d'identifiants de plusieurs fournisseurs courants, y compris:

  • GitHub
  • Services
  • OpenID
  • Twitter

De plus, si vous possédez déjà un compte Apigee Edge, vous pouvez utiliser ces identifiants pour vous connecter au portail des développeurs.

Chacun des fournisseurs d'identifiants compatibles nécessite un processus de configuration différent, comme décrit ci-dessous.

Utiliser des identifiants fédérés avec le portail des développeurs

Pour accéder au portail, un développeur y enregistre un nouveau compte et spécifie un nom d'utilisateur, une adresse e-mail et un mot de passe. L'utilisateur peut ensuite se connecter au portail en fournissant le nom d'utilisateur et le mot de passe de son portail comme identifiants.

Avec la connexion fédérée sur le portail, vous utilisez les identifiants d'un tiers pour vous connecter à un compte de portail existant. Autrement dit, vous devez disposer d'un compte sur le portail pour pouvoir vous connecter avec des identifiants tiers. Vous pouvez utiliser n'importe quelle identifiant fédérée compatible avec Apigee pour vous connecter à un compte de portail existant. De plus, vous pouvez utiliser les identifiants Google et Apigee pour enregistrer un nouveau compte sur le portail.

Se connecter à un compte de portail existant

Connectez-vous à un compte de portail existant en utilisant l'une des identifiants fédérés compatibles. Par exemple, connectez-vous à l'aide de vos identifiants Twitter. La première fois que vous vous connectez avec vos identifiants Twitter, le portail vous invite à associer vos identifiants Twitter à un compte de portail existant. Vous n'effectuez cette association qu'une seule fois. Vous pouvez ensuite vous connecter avec vos identifiants Twitter. Le portail conservera les informations d'association.

Enregistrement d'un nouveau compte de portail

Enregistrez un nouveau compte sur le portail à l'aide de vos identifiants Google ou Apigee. Lorsque vous vous inscrivez en tant que nouveau développeur sur le portail à l'aide d'identifiants fédérés, celui-ci tente d'obtenir des informations, généralement des adresses e-mail, auprès du système d'enregistrement. Par exemple, vous pouvez utiliser vos identifiants Google pour créer un compte de développeur sur le portail. Vous êtes invité à approuver les informations transmises au portail par Google. Même si le système d'enregistrement renvoie des informations au portail, les nouveaux enregistrements sont généralement tenus de saisir certaines informations, comme l'acceptation des conditions d'utilisation.

S'inscrire ou se connecter à l'aide d'identifiants Apigee

Si vous possédez déjà un compte Apigee Edge, vous pouvez utiliser ces identifiants pour enregistrer un compte ou vous connecter à un compte existant sur le portail des développeurs. Par défaut, le bouton suivant apparaît sur les pages d'inscription et de connexion du portail des développeurs:

Le bouton n'apparaît que sur les portails dont l'URL se termine par apigee.com : c'est-à-dire les portails du domaine Apigee. Par exemple, une URL au format http://myCompany.devportal.apigee.com. Si l'URL ne se termine pas par ce domaine, vous ne pouvez pas utiliser vos identifiants Apigee Edge pour vous connecter ou vous inscrire sur le portail.

Pour enregistrer un utilisateur Apigee Edge existant en tant que développeur de portail:

Remarque: Le processus d'enregistrement suppose que votre portail est configuré de manière à permettre à tout le monde de s'inscrire sans l'approbation de l'administrateur. Pour en savoir plus sur le contrôle des personnes autorisées à s'inscrire, consultez la page Ajouter et gérer des comptes utilisateur.

  1. Assurez-vous de disposer d'un compte Apigee Edge.
  2. Sélectionnez le lien "Register" (S'inscrire) sur le portail des développeurs.
  3. Sélectionnez le bouton Authentifier avec Apigee sur la page d'inscription.
    • Si vous n'êtes pas connecté à Apigee Edge, saisissez vos identifiants Apigee Edge et sélectionnez "Se connecter".
  4. Si aucune autre information n'est requise pour vous inscrire, vous serez connecté au portail des développeurs avec votre nouveau compte.
    Vous recevrez un e-mail à l'adresse associée à votre compte Apigee contenant des informations pour terminer le processus d'inscription, par exemple pour définir votre mot de passe.
  5. Si des informations supplémentaires sont requises pour terminer le processus d'inscription, telles que l'acceptation des conditions d'utilisation, vous serez automatiquement redirigé vers la page d'enregistrement avec le nom d'utilisateur et l'adresse e-mail de votre compte Apigee Edge saisis dans les champs appropriés.
  6. Indiquez toute autre information d'enregistrement requise pour terminer le processus d'enregistrement.
  7. Sélectionnez "Créer un compte".
    Vous recevrez un e-mail à l'adresse associée à votre compte Apigee contenant des informations pour terminer le processus d'inscription, par exemple pour définir votre mot de passe.

Pour vous connecter en tant que développeur de portail existant à l'aide d'un compte Apigee:

  1. Sélectionnez le lien de connexion sur le portail des développeurs.
  2. Sélectionnez le bouton Authentifier avec Apigee sur la page de connexion.
    • Si vous êtes déjà connecté à Apigee Edge, vous serez automatiquement connecté au portail des développeurs.
    • Si vous n'êtes pas connecté à Apigee Edge, saisissez vos identifiants Apigee Edge et sélectionnez "Se connecter".

S'inscrire ou se connecter à l'aide d'identifiants Google

L'enregistrement et la connexion fédérées à l'aide d'identifiants Google sont activés par défaut sur le portail des développeurs. Le bouton suivant apparaît sur les pages d'inscription et de connexion:

Vous pouvez vous inscrire en tant que nouveau développeur ou vous connecter en tant que développeur existant à l'aide de vos identifiants Google. Par exemple, si vous possédez un compte Gmail, vous pouvez vous y connecter à l'aide de vos identifiants Gmail.

Le portail des développeurs associe les identifiants Google à votre compte de portail en stockant un Google OpenID dans votre profil de portail. Après avoir associé vos identifiants Google à votre compte de portail, vous pouvez voir l'OpenID en sélectionnant votre adresse e-mail > Modifier le profil dans le menu supérieur du portail des développeurs, puis en sélectionnant "Manage your OpenIDs" (Gérer vos OpenID).

Pour vous inscrire en tant que nouveau développeur à l'aide de vos identifiants Google:

Remarque: Le processus d'enregistrement suppose que votre portail est configuré de manière à permettre à tout le monde de s'inscrire sans l'approbation de l'administrateur. Pour en savoir plus sur le contrôle des personnes autorisées à s'inscrire, consultez la page Ajouter et gérer des comptes utilisateur.

  1. Assurez-vous de disposer d'un compte Google, tel qu'un compte Gmail.
  2. Sélectionnez le lien "Register" (S'inscrire) sur le portail des développeurs.
  3. Sélectionnez le bouton "Authentifier avec Google" sur la page d'inscription.
    Vous serez redirigé vers une page Google vous demandant d'accepter que le portail des développeurs puisse accéder à votre adresse e-mail Google et aux informations de base.
  4. Sélectionnez "Accepter" pour approuver la demande.
  5. Vous êtes redirigé vers la page d'inscription du portail des développeurs, où les informations fournies par Google sont préremplies.
  6. Indiquez toute information requise manquante pour terminer le processus d'enregistrement.
  7. Sélectionnez "Créer un compte".
    Vous recevrez un e-mail sur votre compte Gmail contenant des informations sur la procédure d'inscription.

Pour vous connecter en tant que développeur existant:

  1. Sélectionnez le lien de connexion sur le portail des développeurs.
  2. Sélectionnez le bouton Authentifier avec Google sur la page de connexion.
    • Si vous êtes déjà connecté à Google, vous serez alors connecté au portail.
    • Si vous n'êtes pas connecté à Google, saisissez vos identifiants Google pour vous connecter au portail.
  3. Si vous vous connectez pour la première fois à l'aide d'identifiants Google, vous serez redirigé vers une page du portail où vous devrez associer votre compte Google à un compte existant sur le portail des développeurs:

  4. Copiez l'URL sous votre OpenID.
  5. Sélectionnez le lien de connexion en haut de la page, puis connectez-vous à l'aide de vos identifiants existants pour le portail des développeurs.
  6. Dans le menu supérieur du portail des développeurs, sélectionnez votre adresse e-mail, puis cliquez sur "Edit Profile" (Modifier le profil).
  7. Sur la page de votre profil, sélectionnez "Manage your OpenIDs" (Gérer vos OpenID).
  8. Saisissez l'URL OpenID et sélectionnez "Ajouter OpenID".
    Vous pouvez désormais vous connecter à l'aide de vos identifiants Google.

Se connecter à l'aide d'identifiants Twitter

Vous pouvez vous connecter en tant que développeur existant à l'aide de vos identifiants Twitter, mais vous ne pouvez pas vous inscrire en tant que nouvel utilisateur.

La connexion fédérée à l'aide d'identifiants Twitter nécessite l'activation du module Drupal Twitter Signin sur le portail des développeurs. Une fois ce module activé, le bouton suivant s'affiche sur la page de connexion:

La connexion entre le portail des développeurs et Twitter utilise OAuth pour l'authentification. Par conséquent, avant de pouvoir vous connecter au portail des développeurs avec vos identifiants Twitter, vous devez d'abord créer une application Twitter. Cette application génère ensuite la clé et le code secret client utilisés par le portail des développeurs et par Twitter pour communiquer.

Lors du processus ci-dessous, vous devez d'abord activer le module Twitter Signin sur le portail des développeurs, puis créer l'application Twitter. Une fois l'application créée, revenez au module Twitter Signin et ajoutez les informations de configuration requises à partir de l'application Twitter.

Pour activer le module de connexion Twitter:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Modules dans le menu d'administration de Drupal. La liste de tous les modules Drupal installés s'affiche.
  3. Faites défiler la page vers le bas et cochez la case à côté du module de connexion Twitter.
  4. Enregistrez votre configuration.
    Lorsque vous activez le module Twitter Signin, vous pouvez être informé que d'autres modules doivent également être activés. Veillez à activer ces modules.
  5. Une fois le module de connexion Twitter activé, sélectionnez Configuration > Services Web > Twitter dans le menu Drupal.
    L'écran de configuration Twitter s'affiche.
  6. Cliquez sur l'onglet "Paramètres".
  7. Copiez l'URL de rappel. Vous devez nous fournir une URL au format suivant:

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    Vous avez besoin de cette URL pour créer l'application Twitter.

Créer l'application Twitter:

  1. Accédez à cette page dans un navigateur: https://dev.twitter.com/apps/new et connectez-vous à votre compte Twitter.
  2. Saisissez les informations suivantes concernant votre portail:
    Nom: par exemple MyApigeePortal
    Description: par exemple Mon portail Apigee
    Site Web: par exemple http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL (URL de rappel) : copiez l'URL de rappel depuis l'écran de configuration du module de connexion Twitter.
  3. Acceptez les conditions d'utilisation.
    Vous serez redirigé vers une page Twitter contenant les paramètres OAuth, y compris la clé et le code secret client. Vous avez besoin de la clé et du code secret pour configurer le module de connexion Twitter de Drupal.
  4. Dans l'onglet "Paramètres", définissez l'accès au type d'application sur "Lecture et écriture".
  5. Sélectionnez "Mettre à jour les paramètres de cette application Twitter".

Pour configurer le module de connexion Twitter:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Configuration > Services Web > Twitter dans le menu Drupal.
    L'écran de configuration Twitter s'affiche.
  3. Cliquez sur l'onglet "Paramètres".
  4. Copiez la clé client de la page Twitter dans le champ "Clé client OAuth".
  5. Copiez le code secret client de la page Twitter dans le champ "Code secret client OAuth".
  6. Sélectionnez "Enregistrer la configuration".
  7. Sélectionnez l'onglet Twitter.
  8. Tout en étant connecté à Twitter avec le compte qui a créé l'application Twitter, sélectionnez le bouton Accéder à Twitter pour ajouter un compte authentifié.
  9. Sélectionnez l'onglet Connexion.
  10. Sélectionnez Non sous Enregistrer automatiquement les nouveaux utilisateurs.
  11. Enregistrez la configuration.
    Les utilisateurs de Twitter peuvent désormais s'inscrire sur le portail des développeurs et se connecter à l'aide de leurs identifiants Twitter.

Pour vous connecter en tant que développeur existant avec un compte Twitter:

  1. Sélectionnez le lien de connexion sur le portail des développeurs.
  2. Sélectionnez le bouton Authentifier avec Twitter sur la page de connexion.
  3. Vous êtes redirigé vers une page Twitter.
    • Si vous êtes déjà connecté à Twitter, sélectionnez "Autoriser l'application".
    • Si vous n'êtes pas déjà connecté à Twitter, saisissez vos identifiants Twitter, puis sélectionnez "Autoriser l'application".
  4. Si vous vous connectez pour la première fois à l'aide d'identifiants Twitter, vous êtes redirigé vers une page du portail où vous devez associer votre compte Twitter à un compte existant sur le portail des développeurs.
  5. Saisissez le nom d'utilisateur et le mot de passe du compte que vous souhaitez associer à votre compte Twitter. Vous n'aurez à le faire qu'une seule fois.
    La prochaine fois que vous vous connecterez avec vos identifiants Twitter, vous serez directement connecté au portail.

Se connecter à l'aide d'identifiants GitHub

Vous pouvez vous connecter en tant que développeur existant à l'aide de vos identifiants GitHub, mais vous ne pouvez pas vous enregistrer en tant que nouvel utilisateur.

La connexion fédérée à l'aide d'identifiants GitHub nécessite l'activation du module Drupal GitHub Connect sur le portail des développeurs. Une fois ce module activé, le bouton suivant s'affiche sur la page de connexion:

La connexion entre le portail des développeurs et GitHub utilise OAuth pour l'authentification. Par conséquent, avant de pouvoir vous connecter au portail des développeurs avec des identifiants GitHub, vous devez d'abord créer une application GitHub. Cette application génère ensuite la clé et le code secret client utilisés par le portail des développeurs et GitHub pour communiquer.

Dans le processus ci-dessous, vous allez d'abord créer l'application GitHub. Après avoir créé l'application, activez le module de connexion GitHub et ajoutez l'ID et le code secret du client à partir de l'application GitHub.

Créez l'application GitHub:

  1. Accédez à cette page dans un navigateur: https://github.com/settings/applications/new et, si nécessaire, connectez-vous à votre compte GitHub.
  2. Saisissez les informations suivantes concernant votre portail:
    Application Name (Nom de l'application) : par exemple MyApigeePortal
    Description: par exemple Mon portail Apigee
    Site Web: par exemple http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL (URL de rappel) : URL de la page d'accueil de votre portail, avec l'extension /github/register/create. Par exemple:

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. (Facultatif) Choisissez une image.
  4. Sélectionnez "Enregistrer l'application". Le site GitHub affiche l'ID client et le code secret du client dont vous avez besoin pour configurer le module de connexion GitHub sur le portail des développeurs, au format suivant:
    ID client: dbe86111e411d031d8fb
    Code secret du client: e6bd0f838a288113e8b4e531cb6a9487c27f2d
  5. Copiez ces valeurs à utiliser lors de la configuration du module de connexion GitHub.

Pour activer le module de connexion GitHub:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Modules dans le menu d'administration de Drupal. La liste de tous les modules Drupal installés s'affiche.
  3. Faites défiler la page vers le bas et cochez la case située à côté du module de connexion GitHub.
  4. Enregistrez votre configuration.
    Lorsque vous activez le module de connexion GitHub, vous pouvez être averti que d'autres modules doivent également être activés. Celles-ci devraient être activées automatiquement.
  5. Une fois le module de connexion GitHub activé, sélectionnez Configuration > People (Personnes) > GitHub dans le menu Drupal.
    L'écran de configuration GitHub s'affiche.
  6. Saisissez l'ID client et le code secret du client provenant de votre application GitHub.
  7. Placez le bloc GitHub Connect où vous souhaitez qu'il s'affiche.
  8. Enregistrez la configuration.

Pour vous connecter en tant que développeur existant à l'aide d'un compte GitHub:

  1. Sélectionnez le lien de connexion sur le portail des développeurs.
  2. Sélectionnez le bouton "Login with GitHub" (Se connecter avec GitHub) sur la page de connexion.
  3. Vous êtes redirigé vers une page GitHub.
    • Si vous êtes déjà connecté à GitHub, sélectionnez "Autoriser l'accès".
    • Si vous n'êtes pas déjà connecté à GitHub, saisissez vos identifiants GitHub et sélectionnez "Autoriser l'application".
  4. Si vous vous connectez pour la première fois à l'aide d'identifiants GitHub, vous êtes redirigé vers une page du portail où vous devez associer votre compte GitHub à un compte existant sur le portail des développeurs.
  5. Saisissez le nom d'utilisateur et le mot de passe du compte que vous souhaitez associer à votre compte GitHub. Vous n'aurez à le faire qu'une seule fois.
    La prochaine fois que vous vous connecterez avec vos identifiants GitHub, vous serez directement connecté au portail.

Se connecter à l'aide d'identifiants OpenID

OpenID vous permet de créer un nom d'utilisateur et un mot de passe uniques que vous pouvez ensuite utiliser pour vous connecter à n'importe quel site compatible avec OpenID. Avec OpenID, votre mot de passe n'est pas partagé, mais il réside uniquement auprès du fournisseur OpenID. Il appartient au fournisseur OpenID de valider votre identité sur un autre site Web. Pour en savoir plus sur OpenID, consultez la page http://openid.net/.

Si vous avez des comptes sur certains des sites Web les plus populaires, tels que Google ou Yahoo, vous possédez déjà un OpenID. Par exemple, un utilisateur de messagerie Yahoo a un OpenID sous la forme:

https://me.yahoo.com/a/UniqueID

où la valeur UniqueID est générée par Yahoo. Vous pouvez utiliser cet OpenID pour vous connecter au portail des développeurs.

Pour prendre en charge OpenID avec le portail des développeurs, vous devez activer le module Drupal OpenID. Aucune autre configuration n'est requise sur le portail des développeurs. Une fois le module OpenID activé, les liens suivants sont automatiquement ajoutés à la page de connexion du portail des développeurs:

Le portail des développeurs associe un OpenID à votre compte de portail en stockant cet OpenID dans votre profil de portail. Après avoir associé un OpenID à votre compte de portail, vous pouvez voir l'OpenID en sélectionnant votre adresse e-mail > Modifier le profil dans le menu supérieur du portail des développeurs, puis en sélectionnant "Manage your OpenIDs" (Gérer vos OpenID).

Pour activer le module OpenID:

  1. Connectez-vous à votre portail en tant qu'utilisateur disposant de droits d'administrateur.
  2. Sélectionnez Modules dans le menu d'administration de Drupal. La liste de tous les modules Drupal installés s'affiche.
  3. Faites défiler la page vers le bas et cochez la case à côté du module OpenID.
  4. Enregistrez votre configuration.
    Aucune autre configuration n'est requise sur le portail des développeurs.

Pour vous connecter en tant que développeur existant à l'aide d'OpenID:

  1. Connectez-vous au portail des développeurs à l'aide des identifiants du portail des développeurs.
  2. Sélectionnez votre adresse e-mail > Modifier le profil dans le menu supérieur de la barre de menu.
  3. Sur la page de votre profil, sélectionnez "Manage your OpenIDs" (Gérer vos OpenID).
  4. Saisissez votre OpenID et sélectionnez "Ajouter un OpenID".
    Vous pouvez maintenant vous connecter avec votre OpenID.
  5. Déconnectez-vous du portail des développeurs.
  6. Sélectionnez Connexion.
  7. Sur la page de connexion, sélectionnez "Se connecter avec OpenID".
  8. Saisissez votre OpenID.
  9. Sélectionnez Connexion.

Vous pouvez également vous connecter directement à un compte de portail des développeurs existant à l'aide de votre OpenID. Lorsque vous effectuez cette opération pour la première fois, il vous est demandé de vous connecter à l'aide des identifiants du portail des développeurs. Lorsque vous vous connectez pour la première fois, votre OpenID est automatiquement associé au compte du portail des développeurs. Vous pouvez désormais vous connecter directement à l'aide de votre OpenID.