Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Fédération SAML 2.0
AWS prend en charge la fédération d'identités avec SAML 2.0 (Security Assertion Markup Language 2.0)
Note
La fédération d'identité IAM SAML prend en charge les réponses SAML cryptées provenant de fournisseurs d'identité SAML-based fédérés (). IdPs IAM Identity Center et Amazon Cognito ne prennent pas en charge les assertions SAML chiffrées provenant des fournisseurs d’identité SAML IAM.
Vous pouvez ajouter indirectement la prise en charge des assertions SAML chiffrées à la fédération des groupes d’identités Amazon Cognito avec les groupes d’utilisateurs Amazon Cognito. Les groupes d’utilisateurs disposent d’une fédération SAML indépendante de la fédération SAML IAM et qui prend en charge la signature et le chiffrement SAML. Bien que cette fonctionnalité ne s'étende pas directement aux groupes d'identités, les groupes d'utilisateurs peuvent appartenir IdPs à des groupes d'identités. Pour utiliser le chiffrement SAML avec des groupes d’identités, ajoutez un fournisseur SAML avec chiffrement à un groupe d’utilisateurs qui est un IdP d’un groupe d’identités.
Votre fournisseur SAML doit être en mesure de chiffrer les assertions SAML à l’aide d’une clé fournie par votre groupe d’utilisateurs. Les groupes d’utilisateurs n’accepteront pas les assertions chiffrées à l’aide d’un certificat fourni par IAM.
La fédération IAM prend en charge les cas d'utilisation suivants :
-
Accès fédéré pour permettre à un utilisateur ou à une application de votre organisation d'appeler les opérations AWS d'API. Ce cas d’utilisation est traité dans la section suivante. Vous utilisez une assertion SAML (dans le cadre de la réponse d'authentification) qui est générée dans votre organisation pour l'obtention d'informations d'identification temporaires. Ce scénario est similaire à d'autres scénarios de fédération pris en charge par IAM, tels que ceux décrits dans Demande d’identifiants de sécurité temporaires et Fédération OIDC. Cependant, les systèmes SAML 2.0 de votre IdPs organisation gèrent de nombreux détails au moment de l'exécution pour effectuer des vérifications d'authentification et d'autorisation.
-
Web-basedauthentification unique (SSO) Console de gestion AWS depuis votre organisation. Les utilisateurs peuvent se connecter à un portail de votre organisation hébergé par un IdP compatible avec SAML 2.0, sélectionner une option à laquelle accéder et être redirigés vers la console sans avoir à fournir d'informations de connexion supplémentaires. AWS Vous pouvez utiliser un IdP SAML tiers pour établir un accès SSO à la console ou créer un IdP personnalisé pour autoriser l'accès de vos utilisateurs externes à la console. Pour plus d'informations sur la création d'un IdP personnalisé, consultez la page Activez l'accès personnalisé du courtier d'identité au AWS console.
Rubriques
Utilisation SAML-based de la fédération pour accéder à l'API AWS
Vue d'ensemble du rôle pour autoriser SAML-federated l'accès à votre AWS resources
Identification unique des utilisateurs au sein de SAML-based la fédération
Configuration d’assertions SAML pour la réponse d’authentification
Permettre aux principaux fédérés SAML 2.0 d'accéder au Console de gestion AWS
Utilisation SAML-based de la fédération pour accéder à l'API AWS
Supposons que vous voulez permettre aux employés de copier les données de leurs ordinateurs dans un dossier de sauvegarde. Vous créez une application que les utilisateurs peuvent exécuter sur leurs ordinateurs. Sur l’instance principale, l’application lit et écrit les objets dans un compartiment Amazon S3. Les utilisateurs n'ont pas d'accès direct à AWS. À la place, le processus suivant est utilisé :
-
A l'aide d'une application cliente, un utilisateur de l'organisation demande son authentification par l'IdP de l'organisation.
-
L'IdP authentifie l'utilisateur en le comparant à la base d'identités de l'organisation.
-
L'IdP crée une assertion SAML à l'aide des informations concernant l'utilisateur et l'envoie à l'application client. Lorsque vous activez le chiffrement SAML pour votre IdP SAML IAM, cette assertion est chiffrée par votre IdP externe.
-
L'application cliente appelle l' AWS STS
AssumeRoleWithSAMLAPI en transmettant l'ARN du fournisseur SAML, l'ARN du rôle à assumer et l'assertion SAML de l'IdP. Si le chiffrement est activé, l’assertion transmise via l’application cliente reste chiffrée pendant le transfert. -
(Facultatif) AWS STS utilise la clé privée que vous avez chargée depuis votre IdP externe pour déchiffrer l'assertion SAML chiffrée.
-
La réponse de l'API à l'application cliente inclut des informations d'identification de sécurité temporaires.
-
L'application cliente utilise ces informations d'identification de sécurité temporaires pour appeler les opérations d'API Amazon S3.
Présentation de la configuration de la fédération SAML 2.0
Avant de pouvoir utiliser la fédération basée sur SAML 2.0 comme décrit dans le scénario et le schéma précédents, vous devez configurer l'IdP de votre organisation et le vôtre Compte AWS pour qu'ils se fassent mutuellement confiance. La procédure suivante décrit le processus général permettant de configurer cette relation d'approbation. Votre organisation doit utiliser un IdP prenant en charge SAML 2.0, comme Microsoft Active Directory Federation Service (services ADFS qui font partie de Windows Server), Shibboleth, ou tout autre fournisseur compatible avec SAML 2.0.
Note
Pour améliorer la résilience de la fédération, nous vous recommandons de configurer votre IdP et votre fédération AWS
pour prendre en charge plusieurs points de terminaison de connexion SAML. Pour plus de détails, consultez l'article du blog sur la AWS sécurité Comment utiliser les points de terminaison SAML régionaux pour le basculement.
Configurez l'IdP de votre organisation et AWS pour se faire confiance
-
Inscrivez-vous AWS en tant que fournisseur de services (SP) auprès de l'IdP de votre organisation. Utilisez le document de métadonnées SAML à partir de
https://region-code.signin.aws.amazon.com/static/saml-metadata.xmlPour obtenir la liste des
region-codevaleurs possibles, consultez la colonne Région dans les AWS Sign-In points de .Vous pouvez éventuellement utiliser le document de métadonnées SAML à partir de
https://signin.aws.amazon.com/static/saml-metadata.xml. -
À l’aide de l’IdP de l’organisation, vous générez un fichier XML de métadonnées SAML équivalent, capable de décrire cet IdP en tant que fournisseur d’identité IAM dans AWS. Il doit inclure le nom de l'émetteur, une date de création, une date d'expiration et des clés qui AWS peuvent être utilisées pour valider les réponses d'authentification (assertions) de votre organisation.
Si vous autorisez l'envoi d'assertions SAML chiffrées depuis votre IdP externe, vous devez générer un fichier de clé privée à l'aide de l'IdP de votre organisation, puis charger ce fichier dans votre configuration IAM SAML au format de fichier .pem. AWS STS a besoin de cette clé privée pour déchiffrer les réponses SAML qui correspondent à la clé publique chargée sur votre IdP.
Note
Tel que défini par le profil d'interopérabilité V2.0 des métadonnées SAML version 1.0
, IAM n'évalue ni ne prend aucune mesure en cas d'expiration des X.509 certificats contenus dans les documents de métadonnées SAML. Si vous êtes préoccupé par l'expiration X.509 des certificats, nous vous recommandons de surveiller les dates d'expiration des certificats et de procéder à une rotation des certificats conformément aux politiques de gouvernance et de sécurité de votre organisation. -
Dans la console IAM, vous créez un fournisseur d’identité SAML. Au cours du processus, vous chargez le document de métadonnées SAML et la clé de déchiffrement privée générés par l’IdP de votre organisation à l’étape Étape 2. Pour de plus amples informations, veuillez consulter Création d’un fournisseur d’identité SAML dans IAM.
-
Dans IAM, créez un ou plusieurs rôles IAM. Dans la politique de confiance du rôle, vous définissez le fournisseur SAML comme principal, ce qui établit une relation de confiance entre votre organisation et AWS. La politique d'autorisation du rôle détermine les actions que les utilisateurs de l'organisation sont autorisés à effectuer dans AWS. Pour de plus amples informations, veuillez consulter Créer un rôle pour un fournisseur d’identité tiers.
Note
Les IdP SAML utilisés dans une politique d'approbation de rôle doivent se trouver dans le même compte que le rôle.
-
Dans l'IdP de l'organisation, vous définissez les assertions qui associent les utilisateurs et les groupes de l'organisation aux rôles IAM. Notez que différents utilisateurs et groupes de l'organisation peuvent être associés à différents rôles IAM. La procédure exacte pour leur mappage dépend de l'IdP utilisé. Dans le scénario précédent d'un dossier Amazon S3 pour les utilisateurs, tous les utilisateurs peuvent être associés au rôle qui fournit les autorisations Amazon S3. Pour de plus amples informations, veuillez consulter Configuration d’assertions SAML pour la réponse d’authentification.
Si votre IdP active le SSO pour la AWS console, vous pouvez configurer la durée maximale des sessions de console. Pour de plus amples informations, veuillez consulter Permettre aux principaux fédérés SAML 2.0 d'accéder au Console de gestion AWS.
-
Dans l'application que vous créez, vous appelez l' AWS Security Token Service
AssumeRoleWithSAMLAPI en lui transmettant l'ARN du fournisseur SAML dans lequel vous avez crééÉtape 3, l'ARN du rôle dans lequel vous devez supposer que vous avez créé et l'assertion SAML concernant l'utilisateur actuel que vous obtenez de votre IdP. Étape 4 AWS s'assure que la demande d'attribution du rôle provient de l'IdP référencé dans le fournisseur SAML.Pour plus d’informations, consultez AssumeRoleWithSAML dans la Référence d’API AWS Security Token Service .
-
Si la demande aboutit, l'API retourne des informations d'identification de sécurité temporaires que votre application peut utiliser pour adresser des demandes signées à AWS. Votre application dispose d'informations sur l'utilisateur actuel et peut accéder aux compartiments Amazon S3 spécifiques à celui-ci, comme décrit dans le scénario précédent.
Vue d'ensemble du rôle pour autoriser SAML-federated l'accès à votre AWS resources
Les rôles que vous créez dans IAM définissent ce que les principaux fédérés SAML de votre organisation sont en mesure d’effectuer dans AWS. Lorsque vous créez la politique d'approbation pour le rôle, vous spécifiez le fournisseur d'identité SAML créé précédemment en tant que Principal. Vous pouvez également ajouter une Condition à la politique d'approbation, afin d'autoriser uniquement les utilisateurs correspondant à certains attributs SAML à accéder au rôle. Par exemple, vous pouvez spécifier que seuls les utilisateurs dont l'affiliation SAML est staff (telle qu'affirmée parhttps://openidp.feide.no) sont autorisés à accéder au rôle, comme illustré par l'exemple de politique suivant :
Note
Les IdP SAML utilisés dans une politique d'approbation de rôle doivent se trouver dans le même compte que le rôle.
La clé contextuelle saml:aud dans la politique spécifie l’URL que votre navigateur affiche lorsque vous vous connectez à la console. Cette URL de point de terminaison de connexion doit correspondre à l’attribut du destinataire de votre fournisseur d’identité. Vous pouvez inclure des URL de connexion dans des régions spécifiques. AWS
recommande d'utiliser des points de terminaison régionaux au lieu du point de terminaison global pour améliorer la résilience de la fédération. Si vous n'avez configuré qu'un seul point de terminaison, vous ne pourrez pas vous fédérer AWS
dans le cas peu probable où le point de terminaison deviendrait indisponible. Pour obtenir la liste des region-code valeurs possibles, consultez la colonne Région dans les AWS
Sign-In points de .
L'exemple suivant montre le format de l'URL de connexion avec l'option region-code
https://
region-code.signin.aws.amazon.com/saml
Si le chiffrement SAML est obligatoire, l’URL de connexion doit inclure l’identifiant unique qu’ AWS attribue à votre fournisseur SAML, que vous trouverez sur la page de détails du fournisseur d’identité. Dans l’exemple suivant, l’URL de connexion comprend un identifiant unique d’IdP, qui nécessite l’ajout de /acs/ au chemin d’accès de connexion.
https://
region-code.signin.aws.amazon.com/saml/acs/IdP-ID
Vous spécifiez la politique d'autorisation dans le rôle comme pour tout autre rôle. Par exemple, si les utilisateurs de votre organisation sont autorisés à administrer des instances Amazon Elastic Compute Cloud, vous devez autoriser explicitement les actions Amazon EC2 dans la politique d'autorisations, comme celles figurant dans la politique AmazonEC2FullAccess gérée.
Pour plus d'informations sur les clés SAML que vous pouvez utiliser dans une politique, consultez Clés disponibles pour SAML-based AWS STS fédération.
Identification unique des utilisateurs au sein de SAML-based la fédération
Lors de la création de politiques d'accès dans IAM, il est souvent utile de pouvoir spécifier des autorisations en fonction de l'identité des utilisateurs. Par exemple, dans le cas d'utilisateurs fédérés à l'aide de SAML, une application peut conserver les informations dans Amazon S3 à l'aide d'une structure similaire à celle-ci :
amzn-s3-demo-bucket/app1/user1
amzn-s3-demo-bucket/app1/user2
amzn-s3-demo-bucket/app1/user3
Vous pouvez créer le compartiment (amzn-s3-demo-bucket) et le dossier (app1) via la console Amazon S3 ou via le AWS CLI, car il s'agit de valeurs statiques. Cependant, les dossiers spécifiques à l'utilisateur (user1user2,user3, etc.) doivent être créés au moment de l'exécution à l'aide de code, car la valeur qui identifie l'utilisateur n'est connue que lors de sa première connexion via le processus de fédération.
Pour créer des politiques qui référencent des détails spécifiques à l'utilisateur dans le nom d'une ressource, l'identité de l'utilisateur doit figurer dans des clés SAML pouvant être utilisées dans les conditions des politiques. Les clés suivantes sont disponibles pour la fédération basée sur SAML 2.0 à utiliser dans les politiques IAM. Vous pouvez utiliser les valeurs retournées par les clés suivantes pour créer des identifiants utilisateur uniques pour des ressources comme des dossiers Amazon S3.
-
AWS. Valeur de hachage basée sur la concaténation de la valeur de réponseIssuer(saml:iss) et d'une chaîne avec l'ID de comptesaml:namequalifieret le nom convivial (dernière partie de l'ARN) du fournisseur SAML dans IAM. La concaténation de l'ID de compte et du nom convivial du fournisseur SAML est disponible dans les politiques IAM en tant que clésaml:doc. L'identifiant du compte et le nom du fournisseur doivent être séparés par un «/», comme dans « 123456789012/provider_name ». Pour plus d'informations, reportez-vous à la clésaml:docdans Clés disponibles pour SAML-based AWS STS fédération.La combinaison de
NameQualifieretSubjectpermet d’identifier de manière unique un principal fédéré SAML. L’exemple de pseudo-code suivant montre comment cette valeur est calculée. Ce pseudocode+indique la concaténation,SHA1représente une fonction qui produit un résumé de message à l'aide de SHA-1, etBase64représente une fonction qui produit une version Base-64 codée de la sortie de hachage.Base64 ( SHA1 ( "https://example.com/saml" + "123456789012" + "/MySAMLIdP" ) )Pour plus d'informations sur les clés de politique disponibles pour SAML-based la fédération, consultezClés disponibles pour SAML-based AWS STS fédération.
-
saml:sub(chaîne). Objet de la demande, qui inclut une valeur qui identifie de manière unique un utilisateur individuel au sein d'une organisation (par exemple,_cbb88bf52c2510eabe00c1642d4643f41430fe25e3). -
saml:sub_type(chaîne). Cette clé peut êtrepersistent,transientou l'URIFormatcomplet des élémentsSubjectetNameIDutilisés dans votre assertion SAML. Une va leurpersistentindique que la valeur desaml:subreste la même pour l'utilisateur pour toutes les sessions. Si la valeur esttransient, l'utilisateur a une valeursaml:subdifférente pour chaque session. Pour plus d'informations sur l'attributNameIDde l'élémentFormat, consultez Configuration d’assertions SAML pour la réponse d’authentification.
L'exemple suivant illustre une politique d'autorisation qui utilise les clés précédentes pour accorder des autorisations à un dossier spécifique à un utilisateur dans Amazon S3. La politique suppose que les objets Amazon S3 sont identifiés à l'aide d'un préfixe qui inclut à la fois saml:namequalifier et saml:sub. Notez que l'élément Condition inclut un test pour vérifier que la valeur de saml:sub_type est définie sur persistent. Si la valeur est transient, l'élément saml:sub de l'utilisateur peut être différent pour chaque session et vous ne devez pas combiner les valeurs pour identifier des dossiers spécifiques aux utilisateurs.
Pour plus d'informations sur le mappage d'assertions de l'IdP et les clés de politique, consultez Configuration d’assertions SAML pour la réponse d’authentification.