Prerequisites

Before you begin, make sure you have completed the following tasks:

  • Created a secret in the Microsoft Azure portal. For information about creating a secret, see the Microsoft Azure documentation.
  • Obtained the following information from the Microsoft Azure portal:
    • Application (client) ID

    • Client Secret

    • Directory (tenant) ID

    • Object ID

    • Secret Key ID


Procedure

  1. From the Cryptographic Security Platform Vault for Secrets webGUI, select Manage > Manage Boxes.

  2. On the Manage Boxes page, select the box where you want to create a secret. The Box page appears.

  3. In the Secrets section, click Create. The Choose a type of secret to create window appears.

  4. Select Azure User. The Create Secret: Azure User wizard appears.

  5. On the About page, complete the following: 

    Option

    Description

    Name

    Enter the name to use for the secret.

    Description

    Enter the optional description for the secret.

    Expires

    Select one of the following: 

    • Use Box Setting—Accepts the global box value. This is the default.

    • No Expiration—The secret does not expire.

    • Specific Date and Time—Allows you to set the specific date and time for the secret to expire.

  6. Click Continue.
  7. On the Secret Details page, complete the following: 

    Option

    Description

    Tenant ID

    Enter the Directory (tenant) ID of the Microsoft Entra ID tenant that contains the App Registration. This GUID appears on the App Registration's Overview page in the Azure portal.

    Client ID

    Enter the Application (client) ID of the Azure App Registration whose credentials this secret manages. This GUID appears on the App Registration's Overview page in the Azure portal.

    Object ID

    Optional. 

    Authentication Type

    Available options:

    • Client Secret
    • Certificate 

    Secret Key ID

    Enter the key ID of the existing client secret or certificate currently active in your Azure App Registration.

    Client Secret

    If you selected Client Secret for the Authentication type, enter the client secret. 

    Client Certificate (PEM)

    If you selected Certificate for the Authentication Type, click Browse to upload the certificate file in PEM format. 

    Private Key (PEM)

    If you selected Certificate for the Authentication Type, click Browse to upload the private key file in PEM format. 

    Checkout Scope

    When registering an Azure secret in Secrets Vault, select the API based on the Authentication Type. Available options:

    • Azure Management API: For a Client Secret, select Azure Management API.
    • Microsoft Graph API: For a Certificate, select Microsoft Graph API.


  8. Click Continue.
  9. On the Rotation Details page, complete the following:

    Option

    Description

    Rotation Duration

    Sets the duration for this secret to be rotated.

    • Use Box Setting—Use the duration set when creating the box. This is the default.

    • Duration—Enter a duration in days, minutes, or hours. This value will overwrite the box settings.

    Validity Days

    Optional. Enter the number of days that each client secret or certificate generated for this App Registration remains valid. It must be an integer between 1 and 3650. The default is 365 days. When the credential is rotated, the new credential remains valid for the specified number of days.

  10. Click Create.