Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Déployer OAuth 2.0 dans ONTAP

Contributeurs
PDF

Le déploiement de la fonctionnalité principale OAuth 2.0 implique trois étapes principales.

Avant de commencer

Vous devez préparer le déploiement OAuth 2.0 avant de configurer ONTAP. Par exemple, vous devez évaluer le serveur d'autorisation, y compris la façon dont son certificat a été signé et s'il est derrière un pare-feu. Voir "Préparez-vous à déployer OAuth 2.0 avec ONTAP" pour en savoir plus.

Étape 1 : installez le certificat du serveur d'authentification

ONTAP inclut un grand nombre de certificats d'autorité de certification racine pré-installés. Ainsi, dans de nombreux cas, le certificat de votre serveur d'autorisation sera immédiatement reconnu par ONTAP sans configuration supplémentaire. Mais selon la façon dont le certificat du serveur d'autorisation a été signé, vous devrez peut-être installer un certificat d'autorité de certification racine et tous les certificats intermédiaires.

Suivez les instructions ci-dessous pour installer le certificat si nécessaire. Vous devez installer tous les certificats requis au niveau du cluster.

Choisissez la procédure appropriée en fonction de votre accès à ONTAP.

Exemple 1. Étapes
System Manager

  1. Dans System Manager, sélectionnez Cluster > Paramètres.

  2. Faites défiler jusqu'à la section sécurité.

  3. Cliquez sur → en regard de certificats.

  4. Sous l'onglet autorités de certification approuvées, cliquez sur Ajouter.

  5. Cliquez sur Importer et sélectionnez le fichier de certificat.

  6. Renseignez les paramètres de configuration de votre environnement.

  7. Cliquez sur Ajouter.

CLI

  1. Commencez l'installation :

    security certificate install -type server-ca

  2. Recherchez le message de console suivant :

    Please enter Certificate: Press <Enter> when done

  3. Ouvrez le fichier de certificat à l'aide d'un éditeur de texte.

  4. Copiez l'intégralité du certificat, y compris les lignes suivantes :

    -----BEGIN CERTIFICATE-----

    -----END CERTIFICATE-----

  5. Collez le certificat dans le terminal après l'invite de commande.

  6. Appuyez sur entrée pour terminer l'installation.

  7. Vérifiez que le certificat est installé à l'aide de l'une des méthodes suivantes :

    security certificate show-user-installed

    security certificate show

Étape 2 : configurer le serveur d'autorisation

Vous devez définir au moins un serveur d'autorisation sur ONTAP. Vous devez choisir les valeurs de paramètre en fonction de votre configuration et de votre plan de déploiement. Révision "Scénarios de déploiement OAuth2" pour déterminer les paramètres exacts nécessaires à votre configuration.

Astuce Pour modifier une définition de serveur d'autorisation, vous pouvez supprimer la définition existante et en créer une nouvelle.

L'exemple ci-dessous est basé sur le premier scénario de déploiement simple à l'adresse "Validation locale". Les oscilloscopes autonomes sont utilisés sans proxy.

Choisissez la procédure appropriée en fonction de votre accès à ONTAP. La procédure CLI utilise des variables symboliques que vous devez remplacer avant d'exécuter la commande.

Exemple 2. Étapes
System Manager

  1. Dans System Manager, sélectionnez Cluster > Paramètres.

  2. Faites défiler jusqu'à la section sécurité.

  3. Cliquez sur + en regard de OAuth 2.0 autorisation.

  4. Sélectionnez plus d'options.

  5. Indiquez les valeurs requises pour votre déploiement, notamment :

    • Nom

    • Application (http)

    • URI du fournisseur JWKS

    • URI de l'émetteur

  6. Cliquez sur Ajouter.

CLI

  1. Créez à nouveau la définition :

    security oauth2 client create -config-name <NAME> -provider-jwks-uri <URI_JWKS> -application http -issuer <URI_ISSUER>

    Par exemple :

    security oauth2 client create \
-config-name auth0 \
-provider-jwks-uri https://superzap.dev.netapp.com:8443/realms/my-realm/protocol/openid-connect/certs \
-application http \
-issuer https://superzap.dev.netapp.com:8443/realms/my-realm

Étape 3 : activez OAuth 2.0

La dernière étape consiste à activer OAuth 2.0. Il s'agit d'un paramètre global pour le cluster ONTAP.

Avertissement N'activez pas le traitement OAuth 2.0 tant que vous n'avez pas confirmé que ONTAP, les serveurs d'autorisation et les services de support ont tous été correctement configurés.

Choisissez la procédure appropriée en fonction de votre accès à ONTAP.

Exemple 3. Étapes
System Manager

  1. Dans System Manager, sélectionnez Cluster > Paramètres.

  2. Faites défiler jusqu'à la section sécurité.

  3. Cliquez sur → en regard de OAuth 2.0 autorisation.

  4. Activer OAuth 2.0 autorisation.

CLI

  1. Activer OAuth 2.0 :

    security oauth2 modify -enabled true

  2. Confirmer que OAuth 2.0 est activé :

    security oauth2 show
Is OAuth 2.0 Enabled: true