Kimlik doğrulaması ve Azure Static Web Apps

Role kullanıcı ekleme

Bir role kullanıcı eklemek için, kullanıcıları belirli rollerle ilişkilendirmenize olanak sağlayan davetler oluşturabilirsiniz. Roller staticwebapp.config.json dosyasında tanımlanır ve korunur.

Davet oluşturma

Davetler tek tek yetkilendirme sağlayıcılarına özgü olduğu için, hangi sağlayıcıları desteklemesi gerektiğini seçerek uygulamanıza yönelik ihtiyaçları göz önünde bulundurabilirsiniz. Bazı sağlayıcılar kullanıcının e-posta adresini, diğerleri ise yalnızca sitenin kullanıcı adını sağlar.

1. içinde bir Static Web Apps kaynağına Azure portal.
2. Ayarlar altında Rol Yönetimi'ne tıklayın.
3. Davet et düğmesine tıklayın.
4. Seçenekler listesinden bir Yetkilendirme sağlayıcısı seçin.
5. Davet ayrıntıları kutusuna alıcının kullanıcı adını veya e-posta adresini ekleyin.
   • Kullanıcı GitHub Twitter için kullanıcı adını girersiniz. Diğer tüm alıcılar için alıcının e-posta adresini girin.
6. Etki alanı açılan listesinden statik sitenizin etki alanını seçin.
   • Seçerek etki alanı, davette görünen etki alanıdır. Siteniz ile ilişkilendirilmiş bir özel etki alanınız varsa, büyük olasılıkla özel etki alanını seçmek istiyorsanız.
7. Rol kutusuna rol adlarının virgülle ayrılmış bir listesini ekleyin.
8. Davetin geçerli kalmasını istediğiniz en fazla saat sayısını girin.
   • Maksimum olası sınır 168 saattir ve bu da 7 gündür.
9. Oluştur düğmesine tıklayın.
10. Davet et bağlantı kutusundan bağlantıyı kopyalayın.
11. Davet bağlantısını uygulamanıza erişim izni vermekte olduğunu kişiye e-posta ile gönderin.

Kullanıcı davette bağlantıya tıkladığında ilgili hesabıyla oturum açması istenir. Oturum başarıyla oturum açtıktan sonra, kullanıcı seçilen rollerle ilişkilendirilr.

Rol atamalarını güncelleştirme

1. içinde bir Static Web Apps kaynağına Azure portal.
2. Ayarlar altında Rol Yönetimi'ne tıklayın.
3. Listede kullanıcıya tıklayın.
4. Rol kutusunda rol listesini düzenleyin.
5. Güncelleştir düğmesine tıklayın.

Kullanıcı kaldırma

1. içinde bir Static Web Apps kaynağına Azure portal.
2. Ayarlar altında Rol Yönetimi'ne tıklayın.
3. Listede kullanıcı bulun.
4. Kullanıcının satırdaki onay kutusunu işaretleyin.
5. Sil düğmesine tıklayın.

Bir kullanıcı kaldırırken aşağıdaki öğeleri unutmayın:

1. Kullanıcı kaldırılarak izinleri geçersiz kılınıyor.
2. Dünya çapında yayılma birkaç dakika sürebilir.
3. Kullanıcı uygulamaya geri eklenirse, userId değişir.

Yerleşik davet sistemini kullanmak yerine, oturum açmaları zaman kullanıcılara program aracılığıyla roller atamak için sunucusuz bir işlev kullanabilirsiniz.

Bir işlevde özel roller atamak için, bir kullanıcı kimlik sağlayıcısıyla başarıyla kimlik doğrulaması her kullandığında otomatik olarak çağrılır bir API işlevi tanımlayabilirsiniz. İşlev, sağlayıcıdan kullanıcının bilgilerine geçirilebilir. Kullanıcıya atanan özel rollerin listesini iade etmek gerekir.

Bu işlevin örnek kullanımları şunlardır:

• Bir kullanıcının hangi rollere atanacaklarını belirlemek için veritabanını sorgulama
• Kullanıcının Active Directory Graph göre rollerini belirlemek için Microsoft Graph API'sini çağırma
• Kimlik sağlayıcısı tarafından döndürülen taleplere göre kullanıcının rollerini belirleme

Rol atamak için işlev yapılandırma

Bir Static Web Apps api işlevini rol atama işlevi olarak kullanmak üzere yapılandırmak için, uygulama yapılandırma rolesSource dosyasının bölümüne bir özellik auth ekleyin. özelliğinin rolesSource değeri API işlevinin yoludur.

{
  "auth": {
    "rolesSource": "/api/GetRoles",
    "identityProviders": {
      // ...
    }
  }
}

Rol atamak için işlev oluşturma

Uygulama rolesSource yapılandırmasında özelliğini tanımdikten sonra, belirttiğiniz yola statik web uygulamanıza bir API işlevi ekleyin. Yönetilen işlev uygulamasını veya kendi işlev getir uygulamasını kullanabilirsiniz.

Bir kullanıcı kimlik sağlayıcısıyla başarıyla kimlik doğrulaması her kullandığında belirtilen işlev çağrılır. İşleve, istek gövdesinde sağlayıcıdan kullanıcı bilgilerini içeren bir JSON nesnesi geçirilebilir. Bazı kimlik sağlayıcıları için kullanıcı bilgileri, işlevin kullanıcının kimliğini kullanarak API çağrıları yapmak accessToken için kullanabileceği bir de içerir.

Bu, örnek bir yük Azure Active Directory:

{
  "identityProvider": "aad",
  "userId": "72137ad3-ae00-42b5-8d54-aacb38576d76",
  "userDetails": "ellen@contoso.com",
  "claims": [
      {
          "typ": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",
          "val": "ellen@contoso.com"
      },
      {
          "typ": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname",
          "val": "Contoso"
      },
      {
          "typ": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
          "val": "Ellen"
      },
      {
          "typ": "name",
          "val": "Ellen Contoso"
      },
      {
          "typ": "http://schemas.microsoft.com/identity/claims/objectidentifier",
          "val": "7da753ff-1c8e-4b5e-affe-d89e5a57fe2f"
      },
      {
          "typ": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
          "val": "72137ad3-ae00-42b5-8d54-aacb38576d76"
      },
      {
          "typ": "http://schemas.microsoft.com/identity/claims/tenantid",
          "val": "3856f5f5-4bae-464a-9044-b72dc2dcde26"
      },
      {
          "typ": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name",
          "val": "ellen@contoso.com"
      },
      {
          "typ": "ver",
          "val": "1.0"
      }
  ],
  "accessToken": "eyJ0eXAiOiJKV..."
}

İşlev, kullanıcıya atanan rolleri belirlemek için kullanıcının bilgilerini kullanabilir. Kullanıcıya atanan özel rol adlarının listesini içeren bir JSON gövdesine sahip bir HTTP 200 yanıtı dönüşletir.

Örneğin, ve rollerine kullanıcı atamak Reader için aşağıdaki yanıtı geri dönüş Contributor yapın:

{
  "roles": [
    "Reader",
    "Contributor"
  ]
}

Kullanıcıya başka roller atamak istemiyorsanız, boş bir roles dizi döndürün.

Daha fazla bilgi edinmek için bkz. öğretici: bir işlevle özel roller atama ve Microsoft Graph.