Power BI ile kullanmak için Azure AD uygulamasını kaydetme

Bu adımlarda bir Azure AD uygulamasını Power BI müşterileriniz için ekleme çözümüne nasıl kaydedebileceğiniz anlatılmıştır.

1. Power BI Uygulama Kayıt Aracı'nı açın.

2. Ekleme çözümü seçin bölümünde Müşterileriniz için ekleme'yi seçin.

3. 1. Adım: Power BI'da oturum açma bölümünde Power BI kiracınıza ait olan bir kullanıcıyla oturum açın. Azure AD uygulaması bu kullanıcıya kaydedilir.

   Oturum açtıysanız Azure AD uygulamasını oluşturmak için kullanmak istediğiniz kullanıcıyla oturum açtığınızdan emin olun. Kullanıcıyı değiştirmek için Oturumu kapat bağlantısına tıklayın ve araç yeniden başlatıldıktan sonra tekrar oturum açın.

4. 2. Adım: Uygulamanızı kaydetme bölümünde bulunan alanları aşağıdaki şekilde doldurun:

   • Uygulama Adı: Uygulamanıza bir ad verin.

   • API erişimi: Uygulamanızın ihtiyaç duyduğu Power BI API'lerini (kapsam olarak da bilinir) seçin. Tümünü seç'i kullanarak tüm API'leri seçebilirsiniz. Power BI erişim izinleri hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu uç noktasında izinler ve onay.

5. Kaydet’i seçin.

   Azure AD uygulamanızın Uygulama Kimliği, Özet kutusunda gösterilir. Bu değeri daha sonra kullanmak üzere kopyalayın.

6. (İsteğe bağlı) 3. Adım: Çalışma alanı oluşturma bölümünde Power BI hizmetinde bir çalışma alanı oluşturabilirsiniz.

   • Bir Power BI çalışma alanınız varsa Atla'yı seçin.

   • Çalışma alanı oluşturmak için bir ad belirleyin ve Çalışma alanı oluştur'u seçin. Çalışma alanınızın adı ve kimliği Özet kutusunda gösterilir. Bu değerleri daha sonra kullanmak üzere kopyalayın.

   Not

   Tümleşik analiz örnek uygulamasının beklendiği gibi çalışması için aracı kullanarak bir çalışma alanı oluşturmanız gerekir.

7. (İsteğe bağlı) 4. Adım: İçeriği içeri aktarma bölümünde aşağıdaki seçeneklerden birini belirleyin:

   • Kendi Power BI uygulamanız varsa Atla'yı seçebilirsiniz.

   • Örnek rapor kullanarak örnek bir Power BI uygulaması oluşturmak isterseniz Örnek Power BI raporu'nu ve ardından İçeri aktar'ı seçin.

   • Kendi raporunuzu kullanarak örnek bir Power BI uygulaması oluşturmak isterseniz .pbix dosyasını karşıya yükle'yi seçin, dosyanızı bulun ve ardından İçeri aktar'ı seçin.

8. 5. Adım: İzin verme bölümünde İzin ver'i seçip açılan pencerede Kabul et'i seçin. Bunu yaptığınızda Azure AD uygulamanızın oturum açmış olan kullanıcıyla seçtiğiniz API'lere (kapsam olarak da bilinir) erişmesine izin verilir. Bu kullanıcı, ana kullanıcı olarak da bilinir.

9. (İsteğe bağlı) Bir Power BI çalışma alanı oluşturduysanız ve aracı kullanarak buraya içerik yüklediyseniz bu aşamada Örnek uygulamayı indir'i seçebilirsiniz. Özet kutusundaki tüm bilgileri kopyalamayı unutmayın.

Bu adımlarda bir Azure AD uygulamasını Power BI kuruluşunuz için ekleme çözümüne nasıl kaydedebileceğiniz anlatılmıştır.

1. Power BI Uygulama Kayıt Aracı'nı açın.

2. Ekleme çözümü seçin bölümünde Kuruluşunuz için ekleme'yi seçin.

3. 1. Adım: Power BI'da oturum açma bölümünde Power BI kiracınıza ait olan bir kullanıcıyla oturum açın. Azure AD uygulaması bu kullanıcıya kaydedilir.

   Oturum açtıysanız Azure AD uygulamasını oluşturmak için kullanmak istediğiniz kullanıcıyla oturum açtığınızdan emin olun. Kullanıcıyı değiştirmek için Oturumu kapat bağlantısına tıklayın ve araç yeniden başlatıldıktan sonra tekrar oturum açın.

4. 2. Adım: Uygulamanızı kaydetme bölümünde bulunan alanları aşağıdaki şekilde doldurun:

   • Uygulama Adı: Uygulamanıza bir ad verin.

   • Giriş Sayfası URL'si: Giriş sayfanız için bir URL girin.

   • Yeniden yönlendirme URL'si - Oturum açmanın ardından, uygulama kullanıcılarınız Azure'dan bir kimlik doğrulama kodu alırken bu adrese yeniden yönlendirecek. Şu seçeneklerden birini belirtin:

     • Varsayılan URL kullan: Bu seçenek otomatik olarak örnek bir tümleşik analiz uygulaması oluşturur ve indirir. Varsayılan URL: http://localhost:13526/.

     • Özel URL kullan: Bir tümleşik analiz uygulamanız varsa ve yeniden yönlendirme URL'si olarak kullanmak istediğiniz adresi biliyorsanız bu seçeneği belirleyin.

   • API erişimi: Uygulamanızın ihtiyaç duyduğu Power BI API'lerini (kapsam olarak da bilinir) seçin. Tümünü seç'i kullanarak tüm API'leri seçebilirsiniz. Power BI erişim izinleri hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu uç noktasında izinler ve onay.

5. Kaydet’i seçin.

   Azure AD uygulamanızın Uygulama Kimliği ve Uygulama gizli dizisi değerleri Özet kutusunda görüntülenir. Bu değerleri daha sonra kullanmak üzere kopyalayın.

6. (İsteğe bağlı) 3. Adım: Çalışma alanı oluşturma bölümünde Power BI hizmetinde bir çalışma alanı oluşturabilirsiniz.

   • Bir Power BI çalışma alanınız varsa Atla'yı seçin.

   • Çalışma alanı oluşturmak için bir ad belirleyin ve Çalışma alanı oluştur'u seçin. Çalışma alanınızın adı ve kimliği Özet kutusunda gösterilir. Bu değerleri daha sonra kullanmak üzere kopyalayın.

   Not

   Tümleşik analiz örnek uygulamasının beklendiği gibi çalışması için aracı kullanarak bir çalışma alanı oluşturmanız gerekir.

7. (İsteğe bağlı) 4. Adım: İçeriği içeri aktarma bölümünde aşağıdaki seçeneklerden birini belirleyin:

   • Kendi Power BI uygulamanız varsa Atla'yı seçebilirsiniz.

   • Örnek rapor kullanarak örnek bir Power BI uygulaması oluşturmak isterseniz Örnek Power BI raporu'nu ve ardından İçeri aktar'ı seçin.

   • Kendi raporunuzu kullanarak örnek bir Power BI uygulaması oluşturmak isterseniz .pbix dosyasını karşıya yükle'yi seçin, dosyanızı bulun ve ardından İçeri aktar'ı seçin.

8. (İsteğe bağlı) Bir Power BI çalışma alanı oluşturduysanız ve aracı kullanarak buraya içerik yüklediyseniz bu aşamada Örnek uygulamayı indir'i seçebilirsiniz. Özet kutusundaki tüm bilgileri kopyalamayı unutmayın.

Azure AD el ile uygulama kaydı seçeneğini yalnızca aşağıdaki çözümlerden birini oluşturmak için kullanın:

• Kuruluşunuz için ekleme uygulaması.

• Hizmet sorumlusu ile müşterileriniz için ekleme uygulaması.

  Not

  Bu seçeneği belirlerseniz Azure AD uygulamanızı kaydettikten sonra Power BI izinleri eklemeniz gerekir.

Uygulamalarınızı Azure Active Directory'ye kaydetme hakkında bilgi almak için bkz. Azure Active Directory’ye uygulama kaydetme.

1. Azure portalında oturum açın.

2. Sayfanın sağ üst köşesinden hesabınızı seçerek Azure AD kiracınızı belirleyin.

3. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız arama yapın.

4. Uygulama kayıtları bölümünde Yeni kayıt'ı seçin.

5. Şu alanları doldurun:

   • Ad: Uygulamanıza bir ad verin.

   • Desteklenen hesap türü: Uygulamayı kullanabilecek kişileri seçin.

6. (İsteğe bağlı) Yeniden yönlendirme URL'si bölümünde bir yeniden yönlendirme URL'si ekleyin.

7. Kaydet’i seçin. Uygulamanız kaydedildikten sonra uygulamanızın genel bakış sayfasına yönlendirilirsiniz. Uygulama kimliği değerini bu sayfada görebilirsiniz.

Azure portalında uygulamanızı görüntüleyebilir ve izinlerinde değişiklikler yapabilirsiniz.

1. Azure portalında oturum açın.

2. Sayfanın sağ üst köşesinden hesabınızı seçerek Azure AD kiracınızı belirleyin.

3. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız arama yapın.

4. Sahip olunan uygulamalar sekmesinde uygulamanızı seçin. Uygulamanın Genel bakış sekmesi açılır ve burada Uygulama kimliği değerini görebilirsiniz.

5. API izinleri sekmesini seçin.

6. İzin eklemek için şu adımları izleyin:

   1. İzin ekle'yi ve ardından Power BI hizmeti'ni seçin.

   2. Temsilci İzinleri'ni seçip istediğiniz izinleri ekleyin veya kaldırın.

   3. İşiniz bittiğinde İzin ekle'yi seçerek yaptığınız değişiklikleri kaydedin.

7. Bir izni kaldırmak için aşağıdaki adımları izleyin:

   1. İznin sağ tarafındaki üç nokta (...) simgesini seçin.

   2. İzni kaldır'ı seçin.

   3. İzni kaldır açılan penceresinde Evet, kaldır'ı seçin.

Azure AD uygulama izinlerinizi program aracılığıyla değiştirmek için kiracınızın içindeki var olan hizmet sorumlularını (kullanıcıları) almanız gerekir. Bunu nasıl yapacağınız hakkında bilgi almak için bkz. servicePrincipal.

1. Kiracınızdaki tüm hizmet sorumlularını almak için Get servicePrincipal API'sini {ID} olmadan çağırın.

2. appId özelliği uygulamanızın kimliği olan hizmet sorumlusunu bulun.

   Post https://graph.microsoft.com/v1.0/servicePrincipals HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "accountEnabled" : true,
   "appId" : "{App_Client_ID}",
   "displayName" : "{App_DisplayName}"
   }
   

   Not

   displayName isteğe bağlıdır.

3. consentType için şu değerlerden birini atayarak uygulamanıza Power BI izinleri verin:

   • AllPrincipals: Kiracıdaki tüm kullanıcılar adına izin vermek için yalnızca bir Power BI yöneticisi tarafından kullanılabilir.

   • Principal: Belirli bir kullanıcı adına izinler vermek için kullanılabilir. Bu seçeneği kullanıyorsanız principalId={User_ObjectId} özelliğini istek gövdesine ekleyin.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"c78a3685-1ce7-52cd-95f7-dc5aea8ec98e",
   "scope":"Dataset.ReadWrite.All Dashboard.Read.All Report.Read.All Group.Read Group.Read.All Content.Create Metadata.View_Any Dataset.Read.All Data.Alter_Any",
   "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
   "startTime":"2017-03-29T14:35:32.4933413+03:00"
   }
   

   Not

   • Ana kullanıcı kullanıyorsanız Azure AD'nin onay istemesinden kaçınmak için izinleri ana hesaba vermeniz gerekir.
   • resourceId c78a3685-1ce7-52cd-95f7-dc5aea8ec98e kiracıya bağımlıdır ve evrensel değildir. Bu değer, Azure AD'de Power BI Hizmeti uygulamasının objectId değeridir. Bu değeri Azure portalından almak için Kurumsal uygulamalar > Tüm uygulamalar yolunu izleyip Power BI Hizmeti araması yapın.

4. consentType için bir değer atayarak Azure AD'ye uygulama izni verin.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"61e57743-d5cf-41ba-bd1a-2b381390a3f1",
   "scope":"User.Read Directory.AccessAsUser.All",
   "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
   "startTime":"2017-03-29T14:35:32.4933413+03:00"
   }
   

Azure AD uygulamanızın izinlerini C# kullanarak da değiştirebilirsiniz. Daha fazla bilgi için oAuth2PermissionGrant API’sine göz atın. Sürecinizin bir bölümünü otomatikleştirmeyi düşünüyorsanız bu yöntem fayda sağlayabilir.

HTTP istekleri hakkında daha fazla bilgi için HTTP sekmesine bakın.

var graphClient = GetGraphClient();

currentState.createdApp = await graphClient.Applications
    .Request()
    .AddAsync(application);

System.Threading.Thread.Sleep(2000);

var passwordCredential = new PasswordCredential
{
    DisplayName = "Client Secret Created in C#"
};

currentState.createdSecret = await graphClient.Applications[currentState.createdApp.Id]
    .AddPassword(passwordCredential)
    .Request()
    .PostAsync();

var servicePrincipal = new ServicePrincipal
{
    AppId = currentState.createdApp.AppId
};

currentState.createdServicePrincipal = await graphClient.ServicePrincipals
    .Request()
    .AddAsync(servicePrincipal);

GraphServiceClient graphClient = new GraphServiceClient(authProvider);

// Use oAuth2PermissionGrant to change permissions
var oAuth2PermissionGrant = await graphClient.Oauth2PermissionGrants["{id}"]
               .Request()
               .GetAsync();