Python için Azure Karma Gerçeklik Kimlik Doğrulama Paketi istemci kitaplığı - sürüm 1.0.0b1

Azure Spatial Anchors, Azure Remote Rendering ve diğerleri gibi Karma Gerçeklik hizmetleri kimlik doğrulaması için Karma Gerçeklik güvenlik belirteci hizmetini (STS) kullanır. Bu paket, STS'den Karma Gerçeklik hizmetlere erişmek için kullanılabilecek bir erişim belirteci için Karma Gerçeklik hesap kimlik bilgilerinin alışverişini destekler.

Başlarken

Şu anda desteklenen ortamlar

Bu paket Python 2.7, 3.5, 3.6, 3.7, 3.8 ve 3.9 ile test edilmiştir.

Önkoşullar

• Bir Azure aboneliği.
• Azure Karma Gerçeklik hizmetine sahip bir hesabınız olmalıdır:
  • Azure Remote Rendering
  • Azure Spatial Anchors
• Azure Kimlik kitaplığındaki kimlik doğrulaması ve kimlik bilgileri kavramları hakkında bilgi.
• Bu paketi kullanmak için Python 2.7 veya 3.5 veya üzeri gereklidir.

Paketi yükleme

Azure Karma Gerçeklik Kimlik Doğrulama SDK'sını yükleyin.

pip install --pre azure-mixedreality-authentication

Oluşturma ve kimlik doğrulaması MixedRealityStsClient

bir Karma Gerçeklik hizmeti için erişim belirteci istemek üzere bir istemci nesnesi oluşturmak için, Karma Gerçeklik hizmet kaynağınızın ve 'ine ve öğesine credentialihtiyacınız account identifieraccount domain olacaktır.

Karma Gerçeklik hizmetleri birkaç farklı kimlik doğrulama türünü destekler:

• Hesap Anahtarı kimlik doğrulaması
  • Hesap anahtarları, Karma Gerçeklik hizmetlerini kullanmaya hızlı bir şekilde başlamanızı sağlar. Ancak uygulamanızı üretim ortamına dağıtmadan önce uygulamanızı Azure AD kimlik doğrulamasını kullanacak şekilde güncelleştirmenizi öneririz.
• Azure Active Directory (AD) belirteci kimlik doğrulaması
  • Kurumsal bir uygulama oluşturuyorsanız ve şirketiniz kimlik sistemi olarak Azure AD kullanıyorsa, uygulamanızda kullanıcı tabanlı Azure AD kimlik doğrulamasını kullanabilirsiniz. Ardından mevcut Azure AD güvenlik gruplarınızı kullanarak Karma Gerçeklik hesaplarınıza erişim izni verirsiniz. Ayrıca kuruluşunuzdaki kullanıcılara doğrudan erişim de vekleyebilirsiniz.
  • Aksi takdirde, uygulamanızı destekleyen bir web hizmetinden Azure AD belirteçleri edinmenizi öneririz. İstemci uygulamanızdaki bir Karma Gerçeklik hizmetine erişim için kimlik bilgilerini eklemekten kaçınmanıza olanak sağladığından, üretim uygulamaları için bu yöntemi öneririz.

Ayrıntılı yönergeler ve bilgiler için buraya bakın.

Hesap anahtarı kimlik doğrulamayı kullanma

Karma Gerçeklik hizmet kaynağınıza göz atmak ve bir account keyalmak için Azure Portal'ı kullanın.

Hesap anahtarınız olduktan sonra sınıfını kullanarak istemcinin AzureKeyCredential kimliğini aşağıdaki gibi doğrulayabilirsiniz:

from azure.core.credentials import AzureKeyCredential
from azure.mixedreality.authentication import MixedRealityStsClient

account_id = "<ACCOUNTD ID>"
account_domain = "<ACCOUNT_DOMAIN>"
account_key = "<ACCOUNT_KEY>"
key_credential = AzureKeyCredential(account_key)

client = MixedRealityStsClient(account_id, account_domain, key_credential)

Not: Üretim uygulamaları için hesap anahtarı kimlik doğrulaması önerilmez .

Azure Active Directory Kimlik Bilgilerini Kullanma

Örneklerin çoğunda hesap anahtarı kimlik doğrulaması kullanılır, ancak Azure Kimlik kitaplığını kullanarak Azure Active Directory ile de kimlik doğrulaması yapabilirsiniz. Bu, üretim uygulamaları için önerilen yöntemdir. Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgileri sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity :

Ayrıca, hizmet sorumlunuza Karma Gerçeklik hizmetiniz için uygun rolü atayarak yeni bir AAD uygulaması kaydetmeniz ve Karma Gerçeklik kaynağınıza erişim vermeniz gerekir.

from azure.identity import DefaultAzureCredential
from azure.mixedreality.authentication import MixedRealityStsClient

account_id = "<ACCOUNTD ID>"
account_domain = "<ACCOUNT_DOMAIN>"
default_credential = DefaultAzureCredential()

client = MixedRealityStsClient(account_id, account_domain, default_credential)

Önemli kavramlar

MixedRealityStsClient

MixedRealityStsClient, erişim belirteci almak için Karma Gerçeklik STS'ye erişmek için kullanılan istemci kitaplığıdır. Erişim belirteci bir MixedRealityStsClient örnekte çağrılarak get_token() alınabilir.

Karma Gerçeklik STS'den alınan belirteçlerin yaşam süresi 24 saattir.

Belirteç sonuç değeri

başarılı bir çağrısının get_token dönüş değeri bir azure.core.credentials.AccessTokendeğeridir.

Daha karmaşık kimlik doğrulama senaryoları için yukarıdaki kimlik doğrulama örneklerine veya Azure Identity'ye bakın.

Erişim belirtecini zaman uyumlu olarak alma

from azure.core.credentials import AzureKeyCredential
from azure.mixedreality.authentication import MixedRealityStsClient

account_id = "<ACCOUNTD ID>"
account_domain = "<ACCOUNT_DOMAIN>"
account_key = "<ACCOUNT_KEY>"
key_credential = AzureKeyCredential(account_key)

client = MixedRealityStsClient(account_id, account_domain, key_credential)

token = client.get_token()

Erişim belirtecini zaman uyumsuz olarak alma

from azure.core.credentials import AzureKeyCredential
from azure.mixedreality.authentication.aio import MixedRealityStsClient

account_id = "<ACCOUNTD ID>"
account_domain = "<ACCOUNT_DOMAIN>"
account_key = "<ACCOUNT_KEY>"
key_credential = AzureKeyCredential(account_key)

client = MixedRealityStsClient(account_id, account_domain, key_credential)

token = await client.get_token()

Örnekler

Bunlar, Azure Karma Gerçeklik Kimlik Doğrulaması istemci kitaplığı ile yaygın senaryo işlemlerini gösteren kod örnekleridir. Örneklerin zaman uyumsuz sürümleri (ile _asynceklenen Python örnek dosyaları) zaman uyumsuz işlemleri gösterir ve Python 3.5 veya üzerini gerektirir. Örnek kodu çalıştırmadan önce Önkoşullar'a bakın

kaynak oluşturmak için, ardından bazı Ortam Değişkenleri ayarlayın

set MIXEDREALITY_ACCOUNT_DOMAIN="<the Mixed Reality account domain>"
set MIXEDREALITY_ACCOUNT_ID="<the Mixed Reality account identifier>"
set MIXEDREALITY_ACCOUNT_KEY="<the Mixed Reality account primary or secondary key>"

pip install azure-mixedreality-authentication

python samples\client_sample.py
python samples\client_sample_async.py

Sorun giderme

Kimlik doğrulaması sorunlarını giderirken Azure Identity için sorun giderme bölümü yararlı olabilir.

Sonraki adımlar

İstemci kitaplıklarını Karma Gerçeklik

• Çok yakında

Katkıda bulunma

Bu proje, katkı ve önerilere açıktır. Çoğu durumda, sağladığınız katkıyı kullanmamız için bize hak tanıma hakkına sahip olduğunuzu ve bu hakkı bize tanıdığınızı bildiren bir Katkıda Bulunan Lisans Sözleşmesi’ni (CLA) kabul etmeniz gerekir. Ayrıntılar için bkz. https://cla.microsoft.com.

Bir çekme isteği gönderdiğinizde, CLA robotu bir CLA sağlamanız gerekip gerekmediğini otomatik olarak belirler ve çekme isteğini uygun şekilde donatır (örn. etiket, açıklama). Robot tarafından sağlanan yönergeleri izlemeniz yeterlidir. Bu işlemi, CLA’mızı kullanarak tüm depolarda yalnızca bir kere yapmanız gerekir.

Bu proje Microsoft Open Source Code of Conduct (Microsoft Açık Kaynak Kullanım Kuralları) belgesinde listelenen kurallara uygundur. Daha fazla bilgi için Kullanım Kuralları SSS bölümüne bakın veya ek sorular veya yorumlarla iletişime geçin opencode@microsoft.com .

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.