Paylaşılan özel uç noktalar aracılığıyla özel bir ağda Key Vault'a erişme

Makale
10/24/2023

Azure SignalR Hizmeti, Paylaşılan Özel Uç Noktalar aracılığıyla özel bir ağda Key Vault'unuza erişebilir. Bu şekilde Key Vault'unuz genel bir ağda kullanıma sunulmaz.

Diagram that shows the architecture of a shared private endpoint.

Azure Özel Bağlantı hizmetiyle tümleştirilmiş bir kaynağa paylaşılan erişim için Azure SignalR Hizmeti API'leri aracılığıyla özel uç noktalar oluşturabilirsiniz. Paylaşılan özel bağlantı kaynakları olarak adlandırılan bu uç noktalar SignalR yürütme ortamında oluşturulur ve bu ortamın dışından erişilemez.

Bu makalede, Key Vault için paylaşılan özel uç nokta oluşturmayı öğreneceksiniz.

Ön koşullar

Bu makaleyi tamamlamak için aşağıdaki kaynaklara ihtiyacınız olacaktır:

Bir Azure kaynak grubu.
bir Azure SignalR Hizmeti örneği.
Azure Key Vault örneği.

Bu makaledeki örneklerde aşağıdaki adlandırma kuralı kullanılır, ancak bunun yerine kendi adlarınızı kullanabilirsiniz.

Bu Azure SignalR Hizmeti kaynak kimliği /subscriptions/00000000-0000-0000-0000-000000000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr'dır.
Azure Key Vault'un kaynak kimliği /subscriptions/00000000-0000-0000-0000-00000000000000/resourceGroups/contoso/providers/Microsoft.KeyVault/vaults/contoso-kv şeklindedir.
Örneklerin geri kalanında contoso-signalr hizmetinin Key Vault'a giden çağrılarının genel ağ yerine özel bir uç noktadan geçmesi için nasıl yapılandırılacağı gösterilmektedir.

Key Vault'a paylaşılan özel bağlantı kaynağı oluşturma

Azure portalı
Azure CLI

Azure portalında Azure SignalR Hizmeti kaynağınıza gidin.
Ağ'ı seçin.
Özel erişim sekmesini seçin.

Paylaşılan özel uç noktalar bölümünde Paylaşılan özel uç nokta ekle'yi seçin.

Aşağıdaki bilgileri girin:

Alan	Açıklama
Dosya Adı	Paylaşılan özel uç noktanın adı.
Türü	Microsoft.KeyVault/vaults'u seçin
Abonelik	Key Vault'unuzu içeren abonelik.
Kaynak	Key Vault kaynağınızın adını girin.
İstek İletisi	"Lütfen onaylayın" yazın

Ekle'yi seçin.

Özel uç noktayı başarıyla eklediğinizde sağlama durumu Başarılı olur. Anahtar Kasası tarafında uç noktayı onaylayana kadar bağlantı durumu Beklemede olur.

Paylaşılan özel bağlantı kaynağı oluşturmak için Azure CLI ile aşağıdaki API çağrısını yapın:

az rest --method put --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/sharedPrivateLinkResources/kv-pe?api-version=2021-06-01-preview --body @create-pe.json

API'ye istek gövdesini temsil eden create-pe.json dosyasının içeriği aşağıdaki gibidir:

{
      "name": "contoso-kv",
      "properties": {
        "privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.KeyVault/vaults/contoso-kv",
        "groupId": "vault",
        "requestMessage": "please approve"
      }
}

Giden özel uç nokta oluşturma işlemi uzun süre çalışan (zaman uyumsuz) bir işlemdir. Tüm zaman uyumsuz Azure işlemlerinde olduğu gibi, PUT çağrı aşağıdaki metne benzer bir Azure-AsyncOperation üst bilgi değeri döndürür:

"Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2021-06-01-preview"

İşlemin durumunu almak için bu URI'yi düzenli aralıklarla yoklayabilirsiniz.

Değeri el ile sorgulayarak Azure-AsyncOperationHeader durumu yoklayabilirsiniz:

az rest --method get --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/operationStatuses/c0786383-8d5f-4554-8d17-f16fcf482fb2?api-version=2021-06-01-preview

Sonraki adımlara geçmeden önce durum Başarılı olarak değişene kadar bekleyin.

Key Vault için özel uç nokta bağlantısını onaylama

Azure portalı
Azure CLI

Key Vault kaynağınıza gidin
Ağ'ı seçin.
Özel uç nokta bağlantıları sekmesini seçin. Zaman uyumsuz işlem başarılı olduktan sonra, önceki API çağrısından gelen istek iletisiyle özel uç nokta bağlantısı isteği olmalıdır.
SignalR Hizmeti oluşturulan özel uç noktayı ve ardından Onayla'yı seçin.
Bağlantıyı onaylamak için Evet'i seçin.

Özel uç nokta bağlantılarını listeleyin.

az network private-endpoint-connection list -n <key-vault-resource-name>  -g <key-vault-resource-group-name> --type 'Microsoft.KeyVault/vaults'

Bekleyen bir özel uç nokta bağlantısı olmalıdır. Kimliğini not edin.

[
    {
        "id": "<id>",
        "location": "",
        "name": "",
        "properties": {
            "privateLinkServiceConnectionState": {
                "actionRequired": "None",
                "description": "Please approve",
                "status": "Pending"
           }
        }
    }
]

Özel uç nokta bağlantısını onaylayın:

az network private-endpoint-connection approve --id <private-endpoint-connection-id>

Paylaşılan özel uç noktanın işlevsel olduğunu doğrulayın

Birkaç dakika sonra onay SignalR Hizmeti yayılır ve bağlantı durumu Onaylandı olarak ayarlanır. Azure portalını veya Azure CLI'yi kullanarak durumu de kontrol edebilirsiniz.

Azure portalı
Azure CLI

az rest --method get --uri https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.SignalRService/signalr/contoso-signalr/sharedPrivateLinkResources/func-pe?api-version=2021-06-01-preview

Komut, bağlantı durumunun "özellikler" bölümünde "durum" olarak gösterildiği bir JSON nesnesi döndürür.

{
      "name": "contoso-kv",
      "properties": {
        "privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.KeyVault/vaults/contoso-kv",
        "groupId": "vaults",
        "requestMessage": "please approve",
        "status": "Approved",
        "provisioningState": "Succeeded"
      }
}

Kaynağın Succeeded "Sağlama Durumu" (properties.provisioningState) ve "Bağlan Durumu" (properties.status) olduğundaApproved, paylaşılan özel bağlantı kaynağı işlevseldir ve SignalR Hizmeti özel uç nokta üzerinden iletişim kurabilir.

SignalR Hizmeti ile Azure Key Vault arasındaki özel uç nokta işlevsel olduğunda, sağlama durumunun değeri Başarılı ve bağlantı durumu Onaylandı olur.

Temizleme

Bu makalede oluşturduğunuz kaynakları kullanmayı planlamıyorsanız Kaynak Grubunu silebilirsiniz.

Dikkat

Kaynak grubu silindiğinde içindeki tüm kaynaklar silinir. Bu makalenin kapsamı dışındaki kaynaklar belirtilen kaynak grubunda varsa, bunlar da silinir.

Aracılığıyla paylaş