Ce guide décrit les étapes pour enregistrer une application dans Microsoft Entra ID (anciennement Azure AD), générer des identifiants d’authentification et accorder les autorisations minimales requises pour lire des secrets depuis un Azure Key Vault. Les valeurs collectées correspondent directement aux champs du fournisseur Azure Key Vault dans l’interface Cloud Exchange Secrets Manager.
Cliquer sur « play » pour regarder une vidéo.
Create a Service Principal
Begin by registering an application in the relevant Microsoft Entra ID tenant. This creates the Identity (service principal) that Cloud Exchange will use.
Utilisez le guide officiel Microsoft pour cette étape : Enregistrer une application auprès de la plateforme d’identité Microsoft
Grant Access to Key Vault (Least Privilege)
After the identity exists, grant it permission to read secrets. Use the Key Vault Secrets User role, which allows reading secrets, but not managing them or viewing keys/certificates.
- Go to the target Key Vault resource in the Azure portal.
- Dans le menu de gauche, sélectionnez Access control (IAM).
- Cliquez sur + Add et sélectionnez Add role assignment.
- Select a Role:
- Search for and select: Key Vault Secrets User
- Permissions included: Get and List secrets.
- Cliquez sur Next.
- Select Members:
- Ensure Assign access to is set to User, group, or service principal.
- Cliquez sur + Select members.
- Search for the name of the application created in Part 1.
- Select le principal dans la liste et cliquez sur Select.
- Click Review + assign to finish.
Configure Authentication Credentials
Choose one of the following options to authenticate the application. These values populate the Authentication Method, Client Secret, and/or Certificate Path fields in the Secrets Manager UI.
Option A: Client Secret (Password-based)
- Go to App registrations in the Azure portal and select the newly created application.
- Dans le menu de gauche, sélectionnez Certificates & secrets.
- Cliquez sur l'onglet Client secrets.
- Cliquez sur + New client secret.
- Add a description (like Netskope CE Secret) and choose an expiration period.
- Cliquez sur Add.
- Copy the Value of the client secret immediately; it cannot be viewed again after leaving the page.
- In Cloud Exchange, paste this value into the Client Secret field.
Option B: Client Certificate (Certificate-based)
Before proceeding, ensure the public key file of the X.509 certificate is available.
- Go to App registrations in the Azure portal and select the application.
- Dans le menu de gauche, sélectionnez Certificates & secrets.
- Cliquez sur l'onglet Certificates.
- Cliquez sur Upload certificate.
- Select the
.crt,.cer, or.pemfile. - Cliquez sur Add.
- In Cloud Exchange, paste the same file in the Certificate field and provide the passphrase if the certificate is encrypted.
Summary of Required Configuration Params
When completed, the following parameters are required to configure the product:
| Paramètres | Source |
|---|---|
| URL du coffre-fort | Azure Portal > Key Vault > Overview > Vault URI |
| Tenant ID | App Registration > Overview > Directory (tenant) ID |
| Identifiant du client | App Registration > Overview > Application (client) ID |
| Secret du client | (If Option A) The value copied. |
| Certificate Path | (Si l'option B) Emplacement du fichier de clé privée téléchargé dans CE. |
| Certificate Passphrase | (If Option B & the certificate is encrypted) The passphrase entered. |
| Secret Name | Key Vault > colonne Secrets > Name (utilisée lors de la référence au secret dans les champs du plugin CE). |

