다음을 통해 공유

Microsoft Entra ID로 Azure Cosmos DB 계정에 대한 관리 ID 구성

적용 대상: NoSQL MongoDB 카산드라 그렘린 테이블

Azure 리소스의 관리 ID는 Microsoft Entra ID에서 자동으로 관리되는 ID를 Azure 서비스에 제공합니다. 이 문서에서는 Azure Cosmos DB 계정에 대한 관리 ID를 만드는 방법을 보여줍니다.

필수 조건

시스템 할당 ID 추가

Azure 포털 사용하기

기존 Azure Cosmos DB 계정에서 시스템 할당 관리 ID를 사용하도록 설정하려면 Azure Portal의 계정으로 이동하고 사이드바 메뉴에서 ID 를 선택합니다.

ID 메뉴 항목

시스템 할당 섹션에서 상태를 켜짐으로 전환하고 저장을 선택합니다. 시스템이 할당한 관리 ID 생성을 확인하라는 메시지가 표시됩니다.

시스템이 할당한 ID 사용 설정

식별자를 생성하고 할당한 후, 해당 객체(위임 주체) 식별자를 검색할 수 있습니다.

시스템이 할당한 ID의 개체 ID 검색

ARM(Azure Resource Manager) 템플릿 사용

중요합니다

관리 ID로 작업할 때는 apiVersion 이상의 2021-03-15을 사용해야 합니다.

신규 또는 기존 Azure Cosmos DB 계정에서 시스템 할당 ID를 사용하도록 설정하려면 리소스 정의에 다음 속성을 포함합니다.

"identity": {
    "type": "SystemAssigned"
}

ARM 템플릿의 resources 섹션은 다음과 같아야 합니다.

"resources": [
    {
        "type": " Microsoft.DocumentDB/databaseAccounts",
        "identity": {
            "type": "SystemAssigned"
        },
        // ...
    },
    // ...
]

Azure Cosmos DB 계정이 만들어지거나 업데이트되면 다음 속성이 표시됩니다.

"identity": {
    "type": "SystemAssigned",
    "tenantId": "<azure-ad-tenant-id>",
    "principalId": "<azure-ad-principal-id>"
}

Azure CLI 사용

새 Azure Cosmos DB 계정을 만드는 동안 시스템 할당 ID를 사용하도록 설정하려면 --assign-identity 옵션을 추가합니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb create \
    -n $accountName \
    -g $resourceGroupName \
    --locations regionName='West US 2' failoverPriority=0 isZoneRedundant=False \
    --assign-identity

명령을 사용하여 az cosmosdb identity assign 기존 계정에 시스템 할당 ID를 추가할 수도 있습니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb identity assign \
    -n $accountName \
    -g $resourceGroupName

Azure Cosmos DB 계정을 만들거나 업데이트한 후 다음 명령을 사용하여 할당된 ID를 az cosmosdb identity show 가져올 수 있습니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb identity show \
    -n $accountName \
    -g $resourceGroupName

{
    "type": "SystemAssigned",
    "tenantId": "<azure-ad-tenant-id>",
    "principalId": "<azure-ad-principal-id>"
}

사용자 할당 ID 추가

Azure 포털 사용하기

기존 Azure Cosmos DB 계정에서 사용자 할당 관리 ID를 사용하도록 설정하려면 Azure Portal의 계정으로 이동하고 사이드바 메뉴에서 ID 를 선택합니다.

ID 메뉴 항목

사용자 할당 섹션에서 + 추가를 선택합니다.

사용자가 할당한 ID 사용 설정

Azure Cosmos DB 계정에 할당할 모든 ID를 찾아 선택한 다음 추가를 선택합니다.

할당할 모든 ID 선택

ARM(Azure Resource Manager) 템플릿 사용

중요합니다

관리 ID로 작업할 때는 apiVersion 이상의 2021-03-15을 사용해야 합니다.

신규 또는 기존 Azure Cosmos DB 계정에서 사용자가 할당한 ID를 사용하도록 설정하려면 리소스 정의에 다음 속성을 포함합니다.

"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "<identity-resource-id>": {}
    }
}

ARM 템플릿의 resources 섹션은 다음 예제처럼 표시되어야 합니다.

"resources": [
    {
        "type": " Microsoft.DocumentDB/databaseAccounts",
        "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": {
                "<identity-resource-id>": {}
            }
        },
        // ...
    },
    // ...
]

Azure Cosmos DB 계정이 만들어지거나 업데이트되면 다음 속성이 표시됩니다.

"identity": {
    "type": "UserAssigned",
    "tenantId": "<azure-ad-tenant-id>",
    "principalId": "<azure-ad-principal-id>"
}

Azure CLI 사용

새 Azure Cosmos DB 계정을 만드는 동안 사용자가 할당한 ID를 사용하도록 설정하려면 --assign-identity 옵션을 추가하고 할당할 ID의 리소스 ID를 전달합니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb create \
    -n $accountName \
    -g $resourceGroupName \
    --locations regionName='West US 2' failoverPriority=0 isZoneRedundant=False \
    --assign-identity <identity-resource-id>

명령을 사용하여 az cosmosdb identity assign 기존 계정에 사용자 할당 ID를 추가할 수도 있습니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb identity assign \
    -n $accountName \
    -g $resourceGroupName
    --identities <identity-resource-id>

Azure Cosmos DB 계정을 만들거나 업데이트한 후 다음 명령을 사용하여 할당된 ID를 az cosmosdb identity show 가져올 수 있습니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb identity show \
    -n $accountName \
    -g $resourceGroupName

{
    "type": "UserAssigned",
    "tenantId": "<azure-ad-tenant-id>",
    "principalId": "<azure-ad-principal-id>"
}

시스템이 할당한 ID 또는 사용자가 할당한 ID 제거

ARM(Azure Resource Manager) 템플릿 사용

중요합니다

관리 ID로 작업할 때는 apiVersion 이상의 2021-03-15을 사용해야 합니다.

Azure Cosmos DB 계정에서 시스템 할당 ID를 제거하려면 type 속성의 identity을 None으로 설정합니다.

"identity": {
    "type": "None"
}

Azure CLI 사용

Azure Cosmos DB 계정에서 모든 관리 ID를 제거하려면 az cosmosdb identity remove 명령을 사용합니다.

resourceGroupName='myResourceGroup'
accountName='mycosmosaccount'

az cosmosdb identity remove \
    -n $accountName \
    -g $resourceGroupName

다음 단계

자습서: Azure Key Vault를 사용하여 Azure Cosmos DB 자격 증명 저장 및 사용