Configuration de SAML 2.0

1. Configurez votre IdP pour intégrer les identités utilisateur issues du Microsoft Active Directory utilisé avec l' WorkSpaces annuaire. Pour un utilisateur possédant un WorkSpace, les attributs sAM AccountName et e-mail de l'utilisateur Active Directory et les valeurs de réclamation SAML doivent correspondre pour que l'utilisateur puisse se connecter à l' WorkSpaces aide de l'IdP. Pour plus d'informations sur l'intégration d'Active Directory dans votre IdP, consultez la documentation de votre IdP.

2. Configurez votre fournisseur d'identité pour établir une relation d'approbation avec AWS.

   • Voir Intégration de fournisseurs de solutions SAML tiers avec des fournisseurs de solutions SAML AWS pour plus d'informations sur la configuration de la AWS fédération. Parmi les exemples pertinents, citons l'intégration d'IdP à AWS IAM pour accéder à la AWS console de gestion.

   • Utilisez votre IdP pour générer et télécharger un document de métadonnées de fédération décrivant votre organisation en tant qu'IdP. Ce document XML signé est utilisé pour établir la relation d'approbation des parties utilisatrices. Enregistrez le fichier dans un emplacement auquel vous pouvez accéder ultérieurement depuis la console IAM.

3. Créez ou enregistrez un répertoire pour à WorkSpaces l'aide de la console WorkSpaces de gestion. Pour plus d'informations, consultez la section Gérer les annuaires pour WorkSpaces. L'authentification SAML 2.0 pour WorkSpaces est prise en charge pour les types de répertoires suivants :

   • AD Connector

   • AWS Microsoft AD géré

4. Créez un WorkSpace pour un utilisateur qui peut se connecter à l'IdP à l'aide d'un type d'annuaire pris en charge. Vous pouvez en créer un WorkSpace à l'aide de la console de WorkSpaces gestion ou de WorkSpaces l'API. AWS CLI Pour plus d'informations, voir Lancer un bureau virtuel à l'aide de WorkSpaces.

Pour créer un rôle IAM pour l'IdP SAML

1. Ouvrez la console IAM à l’adresse https://console.aws.amazon.com/iam/.

2. Dans le panneau de navigation, choisissez Rôles, puis Créer un rôle.

3. Pour Type de rôle, choisissez Fédération SAML 2.0.

4. Pour Fournisseur SAML, sélectionnez l'IdP SAML que vous avez créé.

   Important

   Ne choisissez aucune des deux méthodes d'accès SAML 2.0, ni Autoriser l'accès par programmation uniquement, ni Autoriser l'accès par programme et via Amazon Web Services Management Console.

5. Pour Attribut, choisissez SAML:sub_type.

6. Pour le champ Valeur, saisissez persistent. Cette valeur restreint l'accès du rôle aux demandes de streaming de l'utilisateur SAML qui incluent une assertion de type d'objet SAML avec une valeur « persistent ». Si la valeur de SAML:sub_type est « persistent », votre fournisseur d'identité envoie la même valeur unique pour l'élément NameID dans toutes les demandes SAML à partir d'un utilisateur particulier. Pour plus d'informations sur l'assertion SAML:sub_TYPE, consultez la section Identification unique des utilisateurs dans une fédération basée sur SAML dans Utilisation de la fédération basée sur SAML pour l'accès à l'API. AWS

7. Passez en revue vos informations d’approbation SAML 2.0 pour confirmer l’entité de confiance et la condition, puis choisissez Suivant : Autorisations.

8. Dans la page Attacher des stratégies d’autorisations, choisissez Suivant : balises.

9. (Facultatif) Saisissez une clé et une valeur pour chaque balise que vous souhaitez ajouter. Pour plus d'informations, consultez Étiquette d'utilisateurs IAM et Étiquette de rôles IAM.

10. Lorsque vous avez terminé, sélectionnez Suivant : vérification. Vous pouvez ultérieurement créer et incorporer une politique en ligne pour ce rôle.

11. Pour Nom du rôle, saisissez un nom vous permettant d'identifier le but de ce rôle. Différentes entités pouvant référencer ce rôle, il n’est pas possible de modifier son nom après sa création.

12. (Facultatif) Dans le champ Description du rôle, saisissez la description du nouveau rôle.

13. Passez en revue les détails du rôle, puis choisissez Créer un rôle.

14. Ajoutez l'TagSession autorisation sts : à la politique de confiance de votre nouveau rôle IAM. Pour plus d'informations, consultez Transmission des balises de session dans AWS STS. Sur la page des détails du nouveau rôle IAM, choisissez l'onglet Relations d'approbation, puis choisissez Modifier la relation d'approbation*. Lorsque l'éditeur de politique Edit Trust Relationship s'ouvre, ajoutez l'autorisation sts : TagSession *, comme suit :

    
    {
        "Version": "2012-10-17",
        "Statement": [{
            "Effect": "Allow",
            "Principal": {
                "Federated": "arn:aws:iam::ACCOUNT-ID-WITHOUT-HYPHENS:saml-provider/IDENTITY-PROVIDER"
            },
            "Action": [
                "sts:AssumeRoleWithSAML",
                "sts:TagSession"
            ],
            "Condition": {
                "StringEquals": {
                    "SAML:aud": "https://signin.aws.amazon.com/saml"
                }
            }
        }]
    }    
                   

1. Dans les détails du rôle IAM que vous avez créé, choisissez l'onglet Autorisations, puis ajoutez les autorisations requises à la politique d'autorisations du rôle. L'assistant Créer une politique démarre.

2. Dans Créer une politique, choisissez l'onglet JSON.

3. Copiez et collez le code JSON suivant dans la fenêtre de l'éditeur de politique. Modifiez ensuite la ressource en saisissant votre code de AWS région, votre identifiant de compte et votre identifiant de répertoire. Dans la politique suivante, "Action": "workspaces:Stream" figure l'action qui fournit à vos WorkSpaces utilisateurs les autorisations nécessaires pour se connecter à leurs sessions de bureau dans l' WorkSpaces annuaire.

   
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "workspaces:Stream",
               "Resource": "arn:aws:workspaces:REGION-CODE:ACCOUNT-ID-WITHOUT-HYPHENS:directory/DIRECTORY-ID",
               "Condition": {
                   "StringEquals": {
                       "workspaces:userId": "${saml:sub}"
                   }
               }
           }
       ]
   }
                  

   Remplacez REGION-CODE par la AWS région dans laquelle se trouve votre WorkSpaces répertoire. DIRECTORY-IDRemplacez-le par l'ID du WorkSpaces répertoire, qui se trouve dans la console WorkSpaces de gestion. Pour les ressources en AWS GovCloud (US-West) ou AWS GovCloud (US-East), utilisez le format suivant pour l'ARN :. arn:aws-us-gov:workspaces:REGION-CODE:ACCOUNT-ID-WITHOUT-HYPHENS:directory/DIRECTORY-ID

4. Lorsque vous avez terminé, choisissez Examiner une stratégie. Le programme de validation de politiques signale les éventuelles erreurs de syntaxe.

Pour activer l'intégration avec SAML 2.0

1. Ouvrez la WorkSpaces console à l'adresse https://console.aws.amazon.com/workspaces/.

2. Dans le volet de navigation, choisissez Directories (Annuaires).

3. Choisissez l'ID du répertoire pour votre WorkSpaces.

4. Sous Authentification, choisissez Modifier.

5. Choisissez Modifier le fournisseur d'identité SAML 2.0.

6. Cochez la case Activer l'authentification SAML 2.0.

7. Pour l'URL d'accès utilisateur et le nom du paramètre de lien profond de l'IdP, entrez les valeurs applicables à votre IdP et à l'application que vous avez configurée à l'étape 1. La valeur par défaut du nom du paramètre de lien profond IdP est RelayState « » si vous omettez ce paramètre. Le tableau suivant répertorie les URL d'accès utilisateur et les noms de paramètres propres aux différents fournisseurs d'identité pour les applications.

   Domaines et adresses IP à ajouter à votre liste d'autorisation
   Fournisseur d'identité	Paramètre	URL d'accès utilisateur
   ADFS	RelayState	https://<host>/adfs/ls/idpinitiatedsignon.aspx?RelayState=RPID=<relaying-party-uri>
   Azure AD	RelayState	https://myapps.microsoft.com/signin/<app_id>?tenantId=<tenant_id>
   Duo Single Sign-On	RelayState	https://<sub-domain>.sso.duosecurity.com/saml2/sp/<app_id>/sso
   Okta	RelayState	https://<sub_domain>.okta.com/app/<app_name>/<app_id>/sso/saml
   OneLogin	RelayState	https://<sub-domain>.onelogin.com/trust/saml2/http-post/sso/<app-id>
   JumpCloud	RelayState	https://sso.jumpcloud.com/saml2/<app-id>
   Auth0	RelayState	https://<DefaultTenatName>.us.auth0.com/samlp/<Client_Id>
   PingFederate	TargetResource	https://<host>/idp/startSSO.ping?PartnerSpId=<sp_id>
   PingOne pour Enterprise	TargetResource	https://sso.connect.pingidentity.com/sso/sp/initsso?saasid=<app_id>&idpid=<idp_id>

   L'URL d'accès utilisateur est généralement définie par le fournisseur pour l'authentification unique non sollicitée initiée par un IdP. Un utilisateur peut saisir cette URL dans un navigateur Web pour fédérer directement vers l'application SAML. Pour tester l'URL d'accès utilisateur et les valeurs des paramètres de votre IdP, choisissez Tester. Copiez et collez l'URL de test dans une fenêtre privée de votre navigateur actuel ou d'un autre navigateur pour tester l'ouverture de session SAML 2.0 sans interrompre votre session de console de AWS gestion en cours. Lorsque le flux initié par l'IdP s'ouvre, vous pouvez enregistrer votre WorkSpaces client. Pour plus d'informations, consultez la section Flux initié par le fournisseur d'identité (IdP).

8. Gérez les paramètres de secours en cochant ou en désélectionnant Autoriser les clients qui ne prennent pas en charge le protocole SAML 2.0 à se connecter. Activez ce paramètre pour continuer à permettre à vos utilisateurs d'accéder à WorkSpaces des types de clients ou à des versions qui ne prennent pas en charge le protocole SAML 2.0 ou s'ils ont besoin de temps pour passer à la dernière version du client.

   Note

   Ce paramètre permet aux utilisateurs de contourner SAML 2.0 et de se connecter à l'aide de l'authentification par annuaire en utilisant les anciennes versions du client.

9. Pour utiliser SAML avec le client Web, activez Web Access. Pour plus d'informations, consultez Activer et configurer Amazon WorkSpaces Web Access.

   Note

   PCoIP avec SAML n'est pas pris en charge sur Web Access.

10. Choisissez Enregistrer. Votre WorkSpaces répertoire est désormais activé avec l'intégration de SAML 2.0. Vous pouvez utiliser les flux initiés par l'IDP et par l'application client pour enregistrer les applications WorkSpaces clientes et vous y connecter. WorkSpaces