Le portail Apigee Developer Services (ou simplement le portail ) agit en tant que client d'Apigee Edge. Cela signifie que le portail fonctionnent comme un système autonome. Au lieu de cela, la plupart des informations utilisées par le portail sont en fait stockées sur Edge. Si nécessaire, le portail effectue une demande de récupération d'informations auprès d'Edge ou pour envoyer des informations à Edge.
Le portail est toujours associé à une seule organisation Edge. Lorsque vous configurez vous pouvez spécifier les informations d'authentification de base (nom d'utilisateur et mot de passe) compte de l'organisation que le portail utilise pour communiquer avec Edge.
Si vous choisissez d'activer un IDP externe tel que SAML ou LDAP pour l'authentification Edge, vous pouvez ensuite configurer le portail cette authentification lors de l'envoi de requêtes à Edge. Configurer le portail pour utiliser un IdP externe crée automatiquement un nouveau compte utilisateur machine dans l'organisation Edge que le portail utilise pour envoyer des requêtes à Edge. Pour en savoir plus sur les utilisateurs machine, consultez Automatiser les tâches pour les fournisseurs d'identité externes
L'assistance IdP externe pour le portail nécessite que vous ayez déjà installé et configuré le Module SSO Apigee sur le nœud Edge Management Server. La procédure générale d'activation d'un service externe Le fournisseur d'identité pour le portail se présente comme suit:
- Installez le module d'authentification unique Apigee, comme décrit dans la section Installez l'authentification unique Apigee pour assurer la haute disponibilité.
- Installez le portail et assurez-vous que l'installation fonctionne correctement. Voir Installez le portail.
- Configurez SAML ou LDAP sur le portail, comme décrit dans cette section.
- (Facultatif) Désactivez l'authentification de base sur Edge, comme décrit dans Désactivez l'authentification de base sur Edge.
Créer un utilisateur machine pour le portail
Lorsqu'un IdP externe est activé, Edge prend en charge la génération automatisée de jetons OAuth2 via le et l'utilisation d'utilisateurs machine. Un utilisateur machine peut obtenir des jetons OAuth2 sans avoir à spécifier de code secret. Vous pouvez donc automatiser entièrement le processus d'obtention et d'actualisation d'OAuth2 de jetons.
Le processus de configuration de l'IdP pour le portail crée automatiquement un utilisateur machine dans le organisation associée au portail. Le portail utilise ensuite ce compte utilisateur machine pour connectez-vous à Edge. Pour en savoir plus sur les utilisateurs machine, consultez la section Automatiser pour les fournisseurs d'identité externes.
À propos de l'authentification pour les développeurs de portails comptes
Lorsque vous configurez le portail pour utiliser un IdP externe, vous l'autorisez à utiliser soit le protocole SAML, ou LDAP pour s'authentifier avec Edge afin que le portail puisse envoyer des requêtes à Edge. Toutefois, le portail accepte également un type developers.
Les développeurs constituent la communauté des utilisateurs qui créent des applications à l'aide de vos API. Développeurs d'applications utiliser le portail pour en savoir plus sur vos API, enregistrer les applications qui les utilisent, interagir avec la communauté des développeurs, et d'obtenir des statistiques sur leur utilisation tableau de bord.
Lorsqu'un développeur se connecte au portail, c'est le portail chargé de authentifier le développeur et appliquer des autorisations basées sur les rôles. Le portail continue de utiliser l'authentification de base avec les développeurs, même après avoir activé l'authentification IdP portail et Edge. Pour plus d'informations, consultez la section Communication entre le portail et Edge.
Il est également possible de configurer le portail de sorte qu'il utilise SAML ou LDAP pour authentifier les développeurs. Pour Pour voir un exemple d'activation du protocole SAML à l'aide de modules Drupal tiers, consultez Intégration de l'authentification unique via le protocole SAML avec le portail des développeurs
Fichier de configuration du fournisseur d'identité pour le portail
Pour configurer un IdP externe pour le portail, vous devez créer un fichier de configuration qui définit les paramètres du portail.
L'exemple suivant présente un fichier de configuration de portail compatible avec le fournisseur d'identité:
# IP address of Edge Management Server and the node on which the Apigee SSO module is installed. IP1=22.222.22.222 # URL of Edge management API. MGMT_URL=http://$IP1:8080/v1 # Organization associated with the portal. EDGE_ORG=myorg # Information about the Apigee SSO module (apigee-sso). # Externally accessible IP or DNS of apigee-sso. SSO_PUBLIC_URL_HOSTNAME=$IP1 SSO_PUBLIC_URL_PORT=9099 # Default is http. Set to https if you enabled TLS on apigee-sso. SSO_PUBLIC_URL_SCHEME=http # SSO admin credentials as set when you installed apigee-sso. SSO_ADMIN_NAME=ssoadmin SSO_ADMIN_SECRET=Secret123 # Enables or disables external IDP support. # Default is "n", which disables external IDP support. # Change it to "y" to enable external IDs support. DEVPORTAL_SSO_ENABLED=y # The name of the OAuth2 client used to connect to apigee-sso. # The default client name is portalcli. PORTALCLI_SSO_CLIENT_NAME=portalcli # OAuth client password using uppercase, lowercase, number, and special characters. PORTALCLI_SSO_CLIENT_SECRET=Abcdefg@1 # Email address and user info for the machine user created in the Edge org specified # above by EDGE_ORG. # This account is used by the portal to make requests to Edge. # Add this email as an org admin before configuring the portal to use an external IDP. DEVPORTAL_ADMIN_EMAIL=DevPortal_SAML@google.com DEVPORTAL_ADMIN_FIRSTNAME=DevPortal DEVPORTAL_ADMIN_LASTNAME=SAMLAdmin DEVPORTAL_ADMIN_PWD=Abcdefg@1 # If set, the existing portal OAuth client is deleted and a new one is created. # The default value is "n". # Set to "y" when you configure the external IDP and change the value of # any of the PORTALCLI_* properties. PORTALCLI_SSO_CLIENT_OVERWRITE=y
Pour activer l'assistance IdP externe sur le portail:
- Dans l'interface utilisateur Edge, ajoutez l'utilisateur machine spécifié par
DEVPORTAL_ADMIN_EMAILau organisation associée au portail en tant qu'administrateur de l'organisation. - Exécutez la commande suivante pour configurer l'IdP externe sur le portail:
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f configFile
Où configFile correspond au fichier de configuration décrit ci-dessus.
- Connectez-vous au portail en tant qu'administrateur du portail.
- Dans le menu principal de Drupal, sélectionnez Configuration > Portail des développeurs Le portail
et les paramètres du fournisseur d'identité externe s'affiche:
Veuillez noter les points suivants :
- La case Cette organisation est compatible avec SAML est cochée.
- Le point de terminaison du module d'authentification unique Apigee est renseigné
- Les champs Clé API et Code secret du client client OAuth du portail sont renseignés
- Le message Connection Success (Connexion réussie) s'affiche sous le message Test Connexion.
- Cliquez sur le bouton Tester la connexion pour tester de nouveau la connexion à l'adresse à tout moment.
Pour modifier ces valeurs ultérieurement, mettez à jour le fichier de configuration et exécutez cette procédure. à nouveau.
Désactiver un IdP externe sur le portail
Si vous choisissez de désactiver votre IdP externe pour les communications entre le portail et Edge, le portail ne pourra plus envoyer de requêtes à Edge. Les développeurs peuvent se connecter mais ne pourra pas afficher le produit ni créer d'applications.
Pour désactiver l'authentification IdP externe sur le portail:
- Ouvrez le fichier de configuration que vous avez utilisé précédemment pour activer l'IdP externe.
- Définissez la valeur de la propriété
DEVPORTAL_SSO_ENABLEDsurn, car l'exemple suivant montre:DEVPORTAL_SSO_ENABLED=n
- Configurez le portail en exécutant la commande suivante:
/opt/apigee/apigee-service/bin/apigee-service apigee-drupal-devportal configure-sso -f configFile