Fédération avec les fournisseurs d'identités SAML 2.0

Cette rubrique décrit les étapes générales de fédération d'Oracle Cloud Infrastructure avec un fournisseur d'identités prenant en charge le protocole SAML (Security Assertion Markup Language) 2.0. Si vous souhaitez obtenir des instructions spécifiques pour Oracle Identity Cloud Service ou Microsoft Active Directory, reportez-vous à Fédération avec Oracle Identity Cloud Service ou à Fédération avec Microsoft Active Directory.

Conseil

Vous trouverez des instructions de configuration détaillées pour d'autres fournisseurs d'identités dans les livres blancs suivants :

Instructions de fédération

Voici le processus général suivi par l'administrateur pour configurer le fournisseur d'identités. Les instructions pour chaque étape se trouvent ci-dessous. Il est supposé que l'administrateur est un utilisateur Oracle Cloud Infrastructure disposant des informations d'identification et de l'accès requis.

Remarque

Avant de suivre les étapes de cette rubrique, reportez-vous à Fédération avec les fournisseurs d'identités pour vous assurer que vous comprenez les concepts généraux en matière de fédération.

  1. Dans la console Oracle Cloud Infrastructure, obtenez les métadonnées de fédération requises pour établir une relation d'approbation avec le fournisseur d'identités.
  2. Dans le fournisseur d'identités, configurez Oracle Cloud Infrastructure en tant qu'application (parfois appelée partie de confiance approuvée).
  3. Dans le fournisseur d'identités, affectez des utilisateurs et des groupes à votre nouvelle application Oracle Cloud Infrastructure.
  4. Dans le fournisseur d'identités, obtenez les informations requises par Oracle Cloud Infrastructure.
  5. Dans Oracle Cloud Infrastructure :

    1. Ajoutez le fournisseur d'identités à votre location et fournissez les informations que vous avez obtenues auprès de lui.
    2. Mettez en correspondance les groupes du fournisseur d'identités avec les groupes IAM.
  6. Dans Oracle Cloud Infrastructure, assurez-vous que des stratégies IAM sont configurées pour les groupes afin que vous puissiez contrôler l'accès des utilisateurs aux ressources Oracle Cloud Infrastructure.
  7. Communiquez aux utilisateurs le nom de votre locataire Oracle Cloud Infrastructure et l'URL de la console (https://cloud.oracle.com).

Etape 1 : obtenir des informations auprès d'Oracle Cloud Infrastructure

Récapitulatif : téléchargez en local le document de métadonnées de fédération.

Le document de métadonnées de fédération est un document SAML 2.0 standard qui fournit les informations sur Oracle Cloud Infrastructure que vous devez fournir au fournisseur d'identités. Selon les exigences de configuration de votre fournisseur, vous devrez peut-être télécharger l'intégralité du document vers le serveur ou fournir uniquement des valeurs de métadonnées spécifiques du document.

  1. Connectez-vous à la console Oracle Cloud Infrastructure en tant qu'administrateur.
  2. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Fédération.
  3. Cliquez avec le bouton droit de la souris sur le lien Télécharger ce document et enregistrez le document.

Etape 2 : configurer Oracle Cloud Infrastructure en tant qu'application approuvée

Consultez la documentation de votre fournisseur d'identités pour savoir comment configurer une application approuvée. Reportez-vous au document de métadonnées téléchargé pour découvrir les paramètres requis.

Etape 3 : affecter des utilisateurs et des groupes à la nouvelle application

Suivez les procédures de votre fournisseur d'identités pour ajouter des utilisateurs et des groupes à l'application que vous configurez pour Oracle Cloud Infrastructure.

Etape 4 : télécharger en local le document de métadonnées du fournisseur d'identités

Votre fournisseur d'identités doit fournir un document SAML 2.0 contenant les informations dont Oracle Cloud Infrastructure a besoin pour effectuer la fédération. Reportez-vous à la documentation du fournisseur d'identités pour obtenir des instructions sur le téléchargement de ce document.

Etape 5 : fédérer le fournisseur d'identités avec Oracle Cloud Infrastructure

Récapitulatif : ajoutez le fournisseur d'identités à votre location. Vous pouvez configurer les correspondances de groupes en même temps ou le faire ultérieurement.

Détails :
  1. Accédez à la console et connectez-vous à l'aide de votre nom de connexion et de votre mot de passe Oracle Cloud Infrastructure.
  2. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Fédération.
  3. Cliquez sur Ajouter un fournisseur d'identités.
  4. Entrez les informations suivantes :

    1. Nom : nom unique de l'approbation de fédération. Il s'agit du nom que les utilisateurs fédérés voient lorsqu'ils choisissent le fournisseur d'identités à utiliser pour se connecter à la console. Choisissez donc un nom convivial et intuitif que vos utilisateurs comprendront. Le nom doit être unique pour tous les fournisseurs d'identités que vous ajoutez à la location. Vous ne pouvez pas modifier cet élément ultérieurement.
    2. Description : description conviviale.
    3. Type : sélectionnez Microsoft Active Directory Federation Service (ADFS) ou fournisseur d'identités compatible SAML 2.0.
    4. XML : téléchargez vers le serveur le document metadata.xml que vous avez téléchargé en local à partir de votre fournisseur d'identités.
    5. Crypter l'assertion : le fait de cocher cette case indique au service IAM d'attendre le cryptage fourni par IdP. Si vous cochez cette case, vous devez également configurer le cryptage de l'assertion dans votre IdP. Pour plus d'informations, reportez-vous à Cryptage de l'assertion sous Concepts généraux. Reportez-vous également à la documentation de votre fournisseur d'identités.
    6. Forcer l'authentification : option sélectionnée par défaut. Lorsque cette option est sélectionnée, les utilisateurs doivent indiquer leurs informations d'identification au fournisseur d'identités (réauthentification), même lorsqu'ils sont déjà connectés à une autre session.
    7. Références de classe du contexte d'authentification : ce champ est requis pour les clients Government Cloud. Lorsque des valeurs sont spécifiées, Oracle Cloud Infrastructure (la partie de confiance) s'attend à ce que le fournisseur d'identités utilise l'un des mécanismes d'authentification indiqués lors de l'authentification de l'utilisateur. La réponse SAML renvoyée par le fournisseur d'identités doit contenir une instruction d'authentification avec cette référence de classe du contexte d'authentification. Si le contexte d'authentification de la réponse SAML ne correspond pas à ce qui est indiqué ici, le service d'authentification Oracle Cloud Infrastructure rejette la réponse SAML avec une erreur 400. Plusieurs références de classe du contexte d'authentification courantes sont répertoriées dans le menu. Pour utiliser une autre classe de contexte, sélectionnez Personnalisé et entrez manuellement la référence de classe.
    8. Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à format libre. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
  5. Cliquez sur Continuer.
  6. Configurez les correspondances entre les groupes du fournisseur d'identités et les groupes IAM dans Oracle Cloud Infrastructure. Un groupe d'un fournisseur d'identités donné peut être mis en correspondance avec aucun groupe, un groupe ou plusieurs groupes IAM, et inversement. Cependant, chaque correspondance individuelle se fait uniquement entre un seul groupe d'un fournisseur d'identités et un seul groupe IAM. Les modifications apportées aux correspondances de groupes sont généralement prises en compte au bout de quelques secondes dans votre région d'origine, mais leur propagation vers toutes les régions peut prendre plusieurs minutes.

    Remarque

    Si vous ne souhaitez pas configurer les correspondances de groupes maintenant, vous pouvez simplement cliquer sur Créer et revenir ultérieurement pour les ajouter.

    Pour créer une correspondance de groupes, procédez comme suit :

    1. Sous Groupe de fournisseur d'identités, entrez le nom du groupe dans votre fournisseur d'identités. Vous devez entrer le nom exact en respectant la casse.

      Choisissez le groupe IAM avec lequel mettre en correspondance ce groupe dans la liste sous Groupe OCI.

      Conseil

      Exigences pour le nom du groupe IAM : aucun espace. Caractères autorisés : lettres, chiffres, traits d'union, points, traits de soulignement et signes plus (+). Le nom ne peut pas être modifié ultérieurement.
    2. Répétez les sous-étapes ci-dessus pour chaque correspondance à créer, puis cliquez sur Créer.

Le fournisseur d'identités est alors ajouté à votre location et apparaît dans la liste sur la page Fédération. Cliquez sur le fournisseur d'identités pour visualiser ses détails et les correspondances de groupes que vous venez de configurer.

Oracle affecte un ID unique appelé OCID (Oracle Cloud ID) au fournisseur d'identités et à chaque correspondance de groupes. Pour plus d'informations, reportez-vous à Identificateurs de ressource.

A l'avenir, accédez à la page Fédération si vous souhaitez modifier ou ajouter des correspondances de groupes, ou supprimer le fournisseur d'identités de votre location.

Etape 6 : configurer des stratégies IAM pour les groupes

Si vous ne l'avez pas encore fait, configurez des stratégies IAM pour contrôler l'accès des utilisateurs fédérés aux ressources Oracle Cloud Infrastructure de votre organisation. Pour plus d'informations, reportez-vous à Introduction aux stratégies et à Stratégies courantes.

Etape 7 : fournir aux utilisateurs fédérés le nom du locataire et l'URL de connexion

Les utilisateurs fédérés ont besoin de l'URL de la console Oracle Cloud Infrastructure (https://cloud.oracle.com) et du nom du locataire. Ils seront invités à fournir le nom du locataire lors de leur connexion à la console.

Gestion des fournisseurs d'identités dans la console

Procédure de suppression d'un fournisseur d'identités

Toutes les correspondances de groupes du fournisseur d'identités seront également supprimées.

  1. Supprimez le fournisseur d'identités de votre location :

    1. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Fédération.

      La liste des fournisseurs d'identités de votre location s'affiche.

    2. Cliquez sur le fournisseur d'identités pour afficher ses détails.
    3. Cliquez sur Supprimer.
    4. Confirmez l'opération lorsque vous y êtes invité.
  2. Suivez la documentation du fournisseur d'identités pour supprimer l'application de celui-ci.
Procédure d'ajout de correspondances de groupes pour un fournisseur d'identités
  1. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Fédération.

    La liste des fournisseurs d'identités de votre location s'affiche.

  2. Cliquez sur le fournisseur d'identités pour afficher ses détails.
  3. Cliquez sur Ajouter des correspondances.

    1. Entrez le nom exact du groupe du fournisseur d'identités dans la zone de texte Groupe de fournisseurs d'identités.
    2. Choisissez le groupe IAM avec lequel mettre en correspondance ce groupe dans la liste sous Groupe OCI.

    3. Pour ajouter d'autres correspondances, cliquez sur + Une autre correspondance.
    4. Lorsque vous avez terminé, cliquez sur Ajouter des correspondances.

L'application de vos modifications à votre région d'origine prend généralement quelques secondes. Patientez quelques minutes de plus pour qu'elles se propagent à toutes les régions.

Procédure de mise à jour d'une correspondance de groupes

Vous ne pouvez pas mettre à jour une correspondance de groupes, mais vous pouvez la supprimer et en ajouter une nouvelle.

Procédure de suppression d'une correspondance de groupes
  1. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Fédération.

    La liste des fournisseurs d'identités de votre location s'affiche.

  2. Cliquez sur le fournisseur d'identités pour afficher ses détails.
  3. Sélectionnez la correspondance à supprimer, puis cliquez sur Supprimer.
  4. Confirmez l'opération lorsque vous y êtes invité.

L'application de vos modifications à votre région d'origine prend généralement quelques secondes. Patientez quelques minutes de plus pour qu'elles se propagent à toutes les régions.

Gestion des fournisseurs d'identités dans l'API

Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.

Utilisez les opérations d'API suivantes :

Fournisseurs d'identités : Correspondance de groupes :