Dodawanie tożsamości zarządzanych dla usługi Azure App Configuration

W tym artykule pokazano, jak utworzyć tożsamość zarządzaną dla usługi Azure App Configuration. Tożsamość zarządzana z usługi Microsoft Entra ID umożliwia usłudze Azure App Configuration łatwy dostęp do innych zasobów chronionych przez usługę Microsoft Entra. Tożsamość jest zarządzana przez platformę Azure. Nie wymaga od Ciebie tworzenia ani rotowania żadnych sekretów. Aby uzyskać więcej informacji na temat tożsamości zarządzanych w usłudze Microsoft Entra ID, zobacz Tożsamości zarządzane dla zasobów platformy Azure.

Aplikacja może otrzymać dwa typy tożsamości:

  • Tożsamość przypisana przez system jest powiązana z magazynem konfiguracji. Zostanie on usunięty, jeśli magazyn konfiguracji zostanie usunięty. Magazyn konfiguracji może mieć tylko jedną tożsamość przypisaną przez system.
  • Tożsamość przypisana przez użytkownika to samodzielny zasób platformy Azure, który można przypisać do Twojego magazynu konfiguracji. Magazyn konfiguracji może mieć wiele tożsamości przypisanych przez użytkownika.

Dodawanie tożsamości przypisanej przez system

Utworzenie magazynu konfiguracji aplikacji App Configuration z tożsamością przypisaną przez system wymaga ustawienia dodatkowej właściwości dla tego magazynu.

Przy użyciu interfejsu wiersza polecenia platformy Azure

Aby skonfigurować tożsamość zarządzaną przy użyciu interfejsu wiersza polecenia platformy Azure, użyj polecenia [az appconfig identity assign] dla istniejącego magazynu konfiguracji. Dostępne są trzy opcje uruchamiania przykładów w tej sekcji:

Poniższe kroki przeprowadzą Cię przez proces tworzenia magazynu App Configuration i przypisywania mu tożsamości za pomocą interfejsu CLI. W poniższych przykładach zastąp teksty zastępcze <ResourceGroupName> i <AppConfigurationStoreName> nazwą grupy zasobów oraz unikalną nazwą magazynu usługi App Configuration.

  1. Jeśli używasz interfejsu wiersza polecenia platformy Azure w konsoli lokalnej, najpierw zaloguj się do platformy Azure przy użyciu polecenia [az login]. Użyj konta skojarzonego z subskrypcją platformy Azure:

    az login
    
  2. Utwórz magazyn konfiguracji aplikacji za pomocą interfejsu wiersza polecenia. Aby zobaczyć więcej przykładów korzystania z interfejsu wiersza polecenia z usługą Azure App Configuration, zobacz Przykłady interfejsu wiersza polecenia dla usługi App Configuration:

    az group create --name <ResourceGroupName> --location eastus
    az appconfig create --name <AppConfigurationStoreName> --location eastus --resource-group <ResourceGroupName> --sku Free
    
  3. Uruchom polecenie [az appconfig identity assign], aby utworzyć tożsamość przypisaną przez system dla tego magazynu konfiguracji:

    az appconfig identity assign --name <AppConfigurationStoreName> --resource-group <ResourceGroupName>
    

Dodawanie tożsamości przypisanej przez użytkownika

Utworzenie magazynu App Configuration z tożsamością przypisaną przez użytkownika wymaga utworzenia tej tożsamości, a następnie przypisania do magazynu identyfikatora jej zasobu.

Uwaga

Do magazynu App Configuration można dodać maksymalnie 10 tożsamości zarządzanych przypisanych przez użytkownika.

Przy użyciu interfejsu wiersza polecenia platformy Azure

Aby skonfigurować zarządzaną tożsamość przy użyciu interfejsu wiersza polecenia platformy Azure, użyj polecenia [az appconfig identity assign] dla istniejącego magazynu konfiguracji. Dostępne są trzy opcje uruchamiania przykładów w tej sekcji:

W poniższych krokach opisano tworzenie tożsamości przypisywanej przez użytkownika i magazynu usługi App Configuration, a następnie przypisanie tej tożsamości do magazynu za pomocą interfejsu CLI. W poniższych przykładach zastąp tekst <ResourceGroupName>zastępczy , <AppConfigurationStoreName>, <UserAssignedIdentityName>i <SubscriptionId> własnymi wartościami.

  1. Jeśli używasz interfejsu wiersza polecenia platformy Azure w konsoli lokalnej, najpierw zaloguj się do platformy Azure przy użyciu polecenia [az login]. Użyj konta skojarzonego z subskrypcją platformy Azure:

    az login
    
  2. Utwórz magazyn konfiguracji aplikacji za pomocą interfejsu wiersza polecenia. Aby zobaczyć więcej przykładów korzystania z interfejsu wiersza polecenia z usługą Azure App Configuration, zobacz Przykłady interfejsu wiersza polecenia dla usługi App Configuration:

    az group create --name <ResourceGroupName> --location eastus
    az appconfig create --name <AppConfigurationStoreName> --location eastus --resource-group <ResourceGroupName> --sku Free
    
  3. Utwórz tożsamość przypisaną przez użytkownika o nazwie <UserAssignedIdentityName> przy użyciu interfejsu wiersza polecenia.

    az identity create --resource-group <ResourceGroupName> --name <UserAssignedIdentityName>
    

    W danych wyjściowych tego polecenia zanotuj wartość właściwości id.

  4. Uruchom polecenie [az appconfig identity assign], aby przypisać nową tożsamość przypisaną przez użytkownika do tego magazynu konfiguracji. Użyj wartości właściwości id, zanotowanej w poprzednim kroku.

    az appconfig identity assign --name <AppConfigurationStoreName> --resource-group <ResourceGroupName> --identities /subscriptions/<SubscriptionId>/resourcegroups/<ResourceGroupName>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<UserAssignedIdentityName>
    

Usuwanie tożsamości

Tożsamość przypisana przez system można usunąć, wyłączając tę funkcję przy użyciu polecenia az appconfig identity remove w interfejsie wiersza polecenia platformy Azure. Tożsamości przypisane przez użytkownika można usunąć indywidualnie. Usunięcie tożsamości przypisanej przez system w ten sposób spowoduje również usunięcie jej z identyfikatora Entra firmy Microsoft. Tożsamości przypisane przez system są również automatycznie usuwane z usługi Microsoft Entra ID po usunięciu zasobu aplikacji.

Następne kroki