Şirket içi JavaScript uygulamalarından Azure kaynaklarında kimlik doğrulaması
Azure dışında çalışan uygulamalar (örneğin şirket içi veya üçüncü taraf veri merkezinde), Azure kaynaklarına erişirken Azure'da kimlik doğrulaması yapmak için bir uygulama hizmet sorumlusu kullanmalıdır. Uygulama hizmeti sorumlusu nesneleri, Azure'da uygulama kayıt işlemi kullanılarak oluşturulur. Uygulama hizmet sorumlusu oluşturulduğunda, uygulamanız için bir istemci kimliği ve istemci gizli dizisi oluşturulur. JavaScript için Azure SDK'sının uygulamanızın çalışma zamanında Azure'da kimliğini doğrulamak için ortam değişkenlerini kullanması için istemci kimliğini, istemci gizli dizisini ve kiracı kimliğinizi ortam değişkenlerinde depolarsınız.
Uygulamanın çalıştığı her ortam (test, aşama, üretim gibi) için farklı bir uygulama kaydı oluşturulmalıdır. Bu, her hizmet sorumlusu için ortama özgü kaynak izinlerinin yapılandırılmasına olanak tanır ve bir ortama dağıtılan bir uygulamanın başka bir ortamın parçası olan Azure kaynaklarıyla konuşmadığından emin olun.
1 - Uygulamayı Azure'a kaydetme
Bir uygulama Azure portalı veya Azure CLI kullanılarak Azure'a kaydedilebilir.
Azure portalında oturum açın ve şu adımları izleyin.
| Yönergeler | Ekran görüntüsü |
|---|---|
Azure portalında:
|
|
| Uygulama kayıtları sayfasında + Yeni kayıt'ı seçin. | 
|
Uygulamayı kaydet sayfasında formu aşağıdaki gibi doldurun.
|
|
Uygulamanızın Uygulama kaydı sayfasında:
|
|
| Sertifikalar ve gizli diziler sayfasında + Yeni istemci gizli dizisi'ni seçin. | 
|
İstemci gizli dizisi ekle iletişim kutusu sayfanın sağ tarafından açılır. Bu iletişim kutusunda:
ÖNEMLİ: Gizli dizinin son kullanma tarihinden önce takviminizde bir anımsatıcı ayarlayın. Bu şekilde, bu gizli dizi sona ermeden önce yeni bir gizli dizi ekleyebilir ve uygulamalarınızı güncelleştirebilir ve uygulamanızda hizmet kesintisini önleyebilirsiniz. |
|
| Sertifikalar ve gizli diziler sayfası, istemci gizli dizisinin değerini gösterir. Bu değeri bir metin düzenleyicisinde geçici bir konuma kopyalayın çünkü sonraki bir adımda bu değere ihtiyacınız vardır. ÖNEMLİ: Bu değeri yalnızca bu kez görürsünüz. Bu sayfadan ayrıldıktan veya sayfayı yeniledikten sonra bu değeri bir daha göremezsiniz. Bu istemci gizli dizisini geçersiz kılınmadan başka bir istemci gizli dizisi ekleyebilirsiniz, ancak bu değeri bir daha görmezsiniz. |
|
2 - Uygulama hizmet sorumlusuna rol atama
Ardından, uygulamanızın hangi kaynaklar üzerinde hangi rollere (izinlere) ihtiyacı olduğunu belirlemeniz ve bu rolleri uygulamanıza atamanız gerekir. Rollere kaynak, kaynak grubu veya abonelik kapsamında bir rol atanabilir. Bu örnekte, çoğu uygulama tüm Azure kaynaklarını tek bir kaynak grubunda gruplandırdığından kaynak grubu kapsamında hizmet sorumlusu için rollerin nasıl atanacağı gösterilir.
| Yönergeler | Ekran görüntüsü |
|---|---|
| Azure portalının üst kısmındaki arama kutusunu kullanarak kaynak grubu adını arayarak uygulamanızın kaynak grubunu bulun. İletişim kutusundaki Kaynak Grupları başlığının altındaki kaynak grubu adını seçerek kaynak grubunuza gidin. |
|
| Kaynak grubunun sayfasında sol taraftaki menüden Erişim denetimi (IAM) öğesini seçin. | 
|
Erişim denetimi (IAM) sayfasında:
|
|
Rol ataması ekle sayfasında, kaynak grubu için atanabilecek tüm roller listelenir.
|
|
Sonraki Rol ataması ekle sayfası, rolü hangi kullanıcıya atayabileceğinizi belirtmenize olanak tanır.
|
|
Üye seç iletişim kutusunda:
|
|
| Hizmet sorumlusu Rol ataması ekle ekranında seçili olarak gösterilir. Son sayfaya gitmek için Gözden geçir + ata'yı seçin ve ardından işlemi tamamlamak için Gözden geçir + yeniden ata'yı seçin. |
|
3 - Uygulama için ortam değişkenlerini yapılandırma
Uygulama hizmeti sorumlusu kimlik bilgilerini çalışma zamanında uygulamanızın AZURE_CLIENT_IDkullanımına açmak için JavaScript uygulamanızı çalıştıran işlem için , AZURE_TENANT_IDve AZURE_CLIENT_SECRET ortam değişkenlerini ayarlamanız gerekir. DefaultAzureCredential nesnesi, bu ortam değişkenlerinde hizmet sorumlusu bilgilerini arar.
AZURE_CLIENT_ID=<value>
AZURE_TENANT_ID=<value>
AZURE_CLIENT_SECRET=<value>
4 - Uygulamada DefaultAzureCredential uygulama
Azure SDK istemci nesnelerinin kimliğini Azure'da doğrulamak için uygulamanızın DefaultAzureCredential @azure/kimlik paketindeki sınıfı kullanması gerekir.
İlk olarak uygulamanıza @azure/kimlik paketini ekleyin.
npm install @azure/identity
Ardından, uygulamanızda bir Azure SDK istemci nesnesi oluşturan tüm JavaScript kodları için şunları yapmak istersiniz:
- sınıfını
DefaultAzureCredentialmodülden içeri aktarın@azure/identity. - Bir
DefaultAzureCredentialnesne oluşturun. DefaultAzureCredentialNesnesini Azure SDK istemci nesnesi oluşturucusna geçirin.
Bunun bir örneği aşağıdaki kod kesiminde gösterilmiştir.
// connect-with-default-azure-credential.js
import { BlobServiceClient } from '@azure/storage-blob';
import { DefaultAzureCredential } from '@azure/identity';
import 'dotenv/config'
const accountName = process.env.AZURE_STORAGE_ACCOUNT_NAME;
if (!accountName) throw Error('Azure Storage accountName not found');
const blobServiceClient = new BlobServiceClient(
`https://${accountName}.blob.core.windows.net`,
new DefaultAzureCredential()
);
Yukarıdaki kod nesnesinin örneğini oluşturduğundaDefaultAzureCredential, DefaultAzureCredential ile Azure'a bağlanacak uygulama hizmeti sorumlusu bilgileri için , , AZURE_CLIENT_IDve AZURE_CLIENT_SECRET ortam değişkenlerini AZURE_SUBSCRIPTION_IDAZURE_TENANT_IDokur.