Dynamics 365 Uygulama Kullanıcısı

Gökhan Menteşe 15/03/2022

2 3 dakika okuma süresi

Uygulama Kullanıcısı, geliştiricilere Dynamics 365 verilerine ve varlıklarına programlı erişim sağlayan kavramdır. Uygulama Kullanıcısı olmadığı zamanlarda CRM ’de kimlik doğrulaması yapmak ve işlemleri gerçekleştirmek için lisanslı kullanıcı hesabının Kullanıcı Adı ve Şifresini kullanıyorduk. Bu da sadece entegrasyonlar için fazladan lisans alınmasına sebep oluyordu.

Uygulama Kullanıcısı kullanılarak Dynamics 365 e program (web arayüzü,mobil) üzerinden erişilmese bile uygulamalar üzerinden erişilebilir.

Bu makalede, Uygulama Kullanıcısı oluşturma, Dynamics 365 ortamında tanımlama ve Postman üzerinden Dynamics 365 ortamındaki verilere nasıl ulaşılacağını anlatacağım.

Özet

Öncelikle yapılacak çalışmayı aşağıda özetliyorum.

Ø Azure portal da Uygulama Tanımlama

Ø Dynamics 365 Uygulama Kullanıcısı Ekleme

Ø Postman üzerinden Uygulama Kullanıcısı ile Dynamics 365 ortamındaki verilere ulaşma

Azure Active Directory ‘de Uygulama Tanımlama

Öncelikle https://portal.azure.com adresinden Azure Portal a giriş yapmamız gerekiyor. Giriş aşamasında Administrator yetkisine sahip bir kullanıcı olması ve Uygulama oluşturmak istediğiniz Kiracı (Tenant) da bulunan bir hesap olmasına dikkat etmelisiniz. Ayrıca geçerli bir Azure Aboneliği (Azure Subscription) sahibi olmalısınız.

1. İlk olarak Azure Active Directory i açmamız gerekmektedir. Eğer kısa yollarda veya favorilerde yoksa Tüm Hizmetler kısmında Azure Directory yazarak erişebilirsiniz.

2. Active Directory i açtığımızda sol tarafta bulunan menüden Uygulama kayıtlarına girin.

3. Bu ekranda Yeni Kayıt butonunu kullanarak Active Directory ’de bir uygulama tanımlaması yapabiliriz.

4. Açılan formda aşağıdaki ekran görüntüsünde olduğu gibi girişlerimizi yapıyoruz.

Postman vs. ile kullanırken Access Token alabilmek için yeniden yönlendirme URI si ihtiyacımız bulunmakta, bu nedenle Yeniden Yönlendirme URI’si bölümünde web seçiminde bir tanımlama yapmamız gerekli. Burada default olarak Dynamics 365 ortamı url bilgimizi kullanabiliriz.

5. Uygulama oluşturulduğunda detayları görüntüleyeceğimiz bir ekran çıkacaktır.

Bu sayfada bulunan Uygulama kimliği (Application Id) bilgisini daha sonra kullanacağız. Bu veriyi bir yere kopyalayalım.

Not: Bu bilgi daha önce Client Id olarak kullanılmaktaydı. Daha sonra Application Id olarak değiştirildi. Bu nedenle Client Id = Application Id olarak düşünebilirsiniz.

6. Detay sayfasının üst kısmında yer alan Uç Nokta (Endpoints) butonu, uygulama için geçerli olan OAuth, OpenID, Microsoft Graph API , Federation ve SAML bağlantıları için url bilgilerini içermektedir.

7. Sertifikalar ve gizli diziler (Certificatest & Secrets) kısmından sertifikalarımızı yükleyebilir ya da istemci gizli dizisi (Client Secret) oluşturabiliriz.

Yeni bir istemci gizli dizisi oluşturalım.

8. Açılan formda gerekli bilgileri girelim ve Ekle butonu ile işlemi sonlandıralım.

9. Client Secret için en önemli nokta; oluşan bilgiyi sadece ilk aşamada kopyalayabiliriz, eğer daha sonra bu ekrana girecek olursak herhangi bir şekilde kopyalama işlemi yapamayız.

Bu nedenle ekranı kapatmadan Client Secret bilgisini kopyaladığınıza emin olun.

10. API İzinleri alanında oluşturduğumuz uygulama için gerekli olan API izinlerini tanımlayabiliriz.

Biz Dynamics 365 ile birlikte kullanacağımız için Dynamics CRM i ekleyeceğiz. Bunun için İzin ekleyin butonuna tıklayalım.

11. Açılan ekranda Dynamics CRM i seçelim.

12. İkinci aşamada ise Temsilci izinleri ve user_impersonation seçenekleri işaretlenip, İzin ekle butonu ile işlem tamamlanmalıdır.

13. Bu işlem sonucunda oluşturduğumuz Active Directory Uygulama ile Dynamics 365 Web API erişimi sağlayabiliriz.

Uygulama Kullanıcısı için gerekli işlemleri tamamladık. İsteğe bağlı olarak fazla tanımlamalarda yapılabilir.

Dynamics 365 Uygulama Kullanıcısı Ekleme

1. Power Platform Admin Center da oturum açın.

https://admin.powerplatform.microsoft.com

2. Dynamics 365 ortamı seçelim ve Ayarlar butonuna tıklayalım.

3. Kullanıcılar ve izinler bölümünden Uygulama kullanıcılarına tıklayalım.

4. Uygulama kullanıcıları listesinden Yeni uygulama kullanıcısı butonuna tıklayalım.

5. Uygulama kullanıcısı oluşturun sayfasında Uygulama ekle butonuna tıklayalım.

6. Açılan pencerede Azure Active Directory’de eklediğimiz uygulamayı seçelim ve Ekle butonuna tıklayalım.

7. Departman alanından Dynamics 365 ortamından departman seçimi yapılır.

8. Güvenlik rolleri alanında kullanıcımıza rol ataması yapalım.

9. Güvenlik rolü ekle sayfasında uygulama kullanıcısına vereceğimiz rol veya rolleri seçelim ve Kaydet butonuna tıklayalım.

10. Gerekli girişleri yaptıktan sonra Oluştur butonuna tıklayalım ve uygulama kullanıcımızın oluşmasını sağlayalım.

11. Uygulama kullanıcıları listesine kaydımızın geldiğini göreceksiniz. Ayrıca, Azure Active Directory de oluşturulan Uygulama (istemci) Kimliği ile bu ekrandaki Uygulama Kimliğinin aynı olduğunu fark edeceksiniz.

12. Daha önce Uygulama Kimliği, Client Secret bilgilerini kopyalayalım demiştik. Bu bilgiler ile ortam url imiz birleştirdiğimizde, uygulamanızın Dynamics 365 ortamınıza erişmesine izin vermek için ihtiyacınız olan her şeye sahip olursunuz.