Bartuğ Sevindik

 

Dijitalleşme çağında, iş süreçlerini optimize etme ve verimliliği artırma ihtiyacı her geçen gün daha da artmaktadır. Bu noktada Türkiye’nin lider No-Code Uygulama Geliştirme Platformu olan RIVER, sadece bir uygulama geliştirme aracı değil, aynı zamanda iş süreçlerini modernleştirmek isteyen şirketlere güçlü bir çözüm sunmaktadır. Bu makalede, RIVER platformu üzerinde Microsoft Graph API entegrasyonunu ve bu entegrasyonun sağladığı avantajları detaylı bir şekilde inceleyeceğiz. Hemen ardından ise, Microsoft Authentication Library (MSAL) kütüphanesini ve JavaScript ile bu kütüphanenin kullanımını ele alarak RIVER platformu üzerindeki entegrasyon sürecini daha iyi anlamış olacağız.

 

River ve Microsoft Entegrasyonunun Kazandırdıkları

Microsoft Graph API, kullanıcıların ve uygulamaların Microsoft bulut hizmetlerine güvenli bir şekilde erişmelerini sağlayan bir kütüphanedir. Bu entegrasyon, RIVER platformunun sunduğu çeşitli avantajları beraberinde getirir. İşte Microsoft Graph API’nin sağladığı temel avantajlar:

  • Güvenlik: Microsoft Graph API, kullanıcıların kimlik doğrulama süreçlerini güvenli bir şekilde yönetir. Telefondan onay alma, çift faktörlü kimlik doğrulama gibi özelliklerle güvenlik seviyesini artırır.
  • Yetkilendirme: RIVER platformu, Microsoft Graph API’nin sağladığı yetenekleri kullanarak uygulamalara belirli yetkilerle erişim imkanı tanır. Bu sayede, kullanıcının sadece belirli işlemlere erişmesine izin verilir.
  • Hız ve Kolay Kullanım: Microsoft Graph API entegrasyonu sayesinde, RIVER platformu tek bir giriş ile kullanıcılara Microsoft’un birçok uygulamasına erişim sağlar. Bu, kullanıcılara hızlı ve kolay bir deneyim sunar.

RIVER platformu, Microsoft Graph API’nin sunduğu güvenlik, yetkilendirme ve hızlı erişim avantajlarından faydalanarak etkili bir entegrasyon gerçekleştirmektedir. Bu sayede kullanıcılar, RIVER platformu üzerinden Microsoft bulut hizmetlerine güvenli ve hızlı bir şekilde erişebilirler.

Microsoft Mail ile Giriş

Öncelikle kullanıcılar River platformuna giriş yaparken sadece kendilerine tanımlı olan e-posta parola kombinasyonu ile değil, microsoft hesapları ile de giriş yapabilir.

RIVER platformunda Microsoft Graph kullanılarak, kullanıcılar Microsoft hesapları üzerinden güvenli giriş yapabilirler. Bu, tek bir tıklama ile platforma erişimi kolaylaştırır.

E-posta Entegrasyonu

Microsoft Graph’nin sunduğu güvenlik ve yetkilendirme özellikleri, RIVER platformu üzerinde e-posta gönderme ve alma işlemlerini sadece güvenli değil, aynı zamanda kullanıcı dostu bir deneyimle gerçekleştirmeyi mümkün kılar. Bu entegrasyon sayesinde Microsoft Outlook’un sağladığı geniş özellikleri kullanıcılarımız RIVER platformu içinde rahatlıkla kullanabilirler.

  • Mail Alımı ve Gönderimi: Microsoft Graph, RIVER platformu üzerinde Microsoft Outlook entegrasyonu ile kullanıcılara mail alıp gönderme olanağı tanır. Kullanıcılar, iş süreçlerini daha etkili yönetebilmek adına platform içinde bu işlemleri kolayca gerçekleştirebilirler.
  • Dosya Transferi: E-posta entegrasyonu ile RIVER platformu üzerinde dosya transferi de güvenli bir şekilde gerçekleştirilebilir. Kullanıcılar, dosyalarını doğrudan e-posta ile paylaşabilir ve alabilirler.
  • Arama ve Filtreleme: Microsoft Graph, e-posta entegrasyonunda arama ve filtreleme özellikleri ile kullanıcılara kolaylık sağlar. Kullanıcılar, geniş veri kümesi içinde istedikleri bilgilere hızla ulaşabilirler.
  • Gönderme İzni Kontrolü: Kullanıcılar, Microsoft Graph’nin yetkilendirme özellikleri sayesinde belirli kişilere e-posta gönderme izinlerini kontrol edebilirler. Bu, hassas bilgilerin güvenli bir şekilde paylaşılmasını sağlar.

Görev Takibi

RIVER platformu, Microsoft ile entegrasyon sayesinde görev takibini daha etkili ve kullanıcı dostu bir hale getirir. Bu entegrasyonun sunduğu özellikler şu şekildedir:

  • Otomatik Görevler: Microsoft ile entegre görev takip sistemi, kullanıcıların manuel olarak eklemeleri gerekmeksizin otomatik görevler ekleyebilmelerine olanak tanır. Bu, iş süreçlerinin otomatize edilmesini sağlar.
  • Ekip İzin Dağılımı: Microsoft entegrasyonu, görev takibi için ekip içinde iyi bir izin dağılımını mümkün kılar. Kullanıcılar, belirli görevlere veya projelere erişim yetkilerini yönetebilirler.
  • Dosya, Yorum ve Süreç Bağlantısı: Kullanıcılar, görevlere dosyaları, yorumları ve süreçleri bağlayabilirler. Bu, görev takibinin daha anlamlı ve bütünsel bir şekilde yapılmasını sağlar.
  • Kanban ve Gantt Şeması: Microsoft entegrasyonu ile görev takibi, kanban panoları ve Gantt şemaları gibi görsel araçlarla desteklenir. Bu, kullanıcılara iş süreçlerini daha iyi planlama ve takip etme imkanı sunar.

Power BI Entegrasyonu

RIVER platformu, Power BI raporlarına erişimi artırmak ve kullanımını kolaylaştırmak için Microsoft entegrasyonunu kullanır. Bu entegrasyonun sağladığı avantajlar şunlardır:

  • Tekrar Giriş Yapmadan Erişim: Power BI raporları, Microsoft Graph ile entegre olarak RIVER platformu içinde tekrar giriş yapmadan kullanılabilir. Kullanıcılar, raporları hızlıca inceleme ve analiz etme imkanına sahiptirler.
  • River Widgetleri İçinde Kullanım: Yeni geliştirilen River widgetleri içinde, Power BI raporları doğrudan entegre edilebilir. Bu sayede kullanıcılar, raporlara daha hızlı ve kullanıcı dostu bir şekilde erişebilirler.

Bu entegrasyonlar, Microsoft Graph’nin sunduğu güvenlik ve hız avantajlarıyla birleşerek RIVER platformunu daha etkili ve kullanıcı odaklı hale getirir. Microsoft’un Outlook, Teams ve Power BI gibi uygulamalarıyla entegre olarak iş süreçlerini optimize etmek ve verimliliği artırmak mümkün hale gelir.

Azure Servisi ve Proje Oluşturma

Azure, bulut tabanlı bir hizmet sağlayıcısıdır ve çeşitli hizmetleri içerir. Bu bölümde, Azure portalından nasıl bir proje oluşturulacağı ve temel yetkileri üzerine odaklanacağız.

Azure Portal Üzerinden Proje Oluşturma

Azure portalı üzerinden yeni bir proje oluşturmak oldukça basittir. İşte temel adımlar:

  • Azure portalına giriş yapın.
  • Sol taraftaki menüden “Create a resource” seçeneğine tıklayın.
  • “Web + Mobile” kategorisinden “Web App” seçeneğini bulun.
  • Gerekli bilgileri doldurarak proje oluşturun.

Azure Projesinin Amaçları ve Kullanımı

Azure projesi, bir uygulama veya servisin bulut üzerinde barındırılması için bir altyapı sağlar. İşte Azure servisinin temel amaçları:

  • Bulut Tabanlı Hizmetler: Azure, uygulamalarınızı ve veritabanlarınızı bulut üzerinde barındırmanıza olanak tanır. Bu, kaynaklara kolay erişim ve ölçeklendirme imkanı sunar.
  • Yüksek Güvenlik: Azure, gelişmiş güvenlik önlemleri ile verilerinizi korur. Kimlik doğrulama, erişim kontrolü ve veri şifreleme gibi güvenlik özellikleri bulunur.
  • Ölçeklenebilirlik: Azure, ihtiyacınıza göre kaynakları artırma veya azaltma yeteneği sunar. Bu sayede uygulamalarınızın performansını optimize etmeniz mümkündür.
  • Farklı Programlama Dilleri ile Uyum: Azure, çeşitli programlama dillerini destekler. .NET, Java, Python, Node.js gibi dillerle yazılan uygulamaları barındırabilir.

Azure Projesinin Temel Yetkileri

Azure projesi oluştururken belirtilen temel yetkiler, genellikle şunları içerir:

  • Kaynak Grubu: Projenizin bulunduğu kaynakları gruplamak için kullanılır.
  • Uygulama Türü: Web App, Mobile App gibi farklı uygulama türlerini seçebilirsiniz.
  • Veri Merkezi Bölgesi: Projenizin barındırılacağı coğrafi bölgeyi seçme imkânı.
  • Veritabanı: İhtiyaca göre Azure veritabanlarını entegre etme yeteneği.

Bu yetkiler, projenin genel yapılandırması ve kullanımını belirler. Azure projesi, geliştiricilere güçlü bir bulut altyapısı sunarak uygulamalarını daha güvenli ve ölçeklenebilir hale getirir.

Bu aşamadan sonra, Azure servisinin sağladığı hizmetlerden biri olan API Hizmetleri’ne geçerek, Azure üzerinden API hizmeti oluşturarak RIVER platformu ile entegrasyonu sağlamış olabiliriz.

Microsoft Graph API Kullanımı

Microsoft Graph API, kullanıcıların ve uygulamaların Microsoft bulut hizmetlerine güvenli bir şekilde erişmelerini sağlayan bir kütüphanedir. Bu kütüphane, kimlik doğrulama ve yetkilendirme işlemlerini kolaylaştırarak uygulama geliştiricilerine büyük avantajlar sunar. Microsoft Graph’nin kullanımı için öncelikle Azure servislerinden yararlanmamız gerekmektedir.

Authentication İşlemleri:

Microsoft Graph kullanarak authentication işlemleri, genellikle bir kullanıcının kimlik doğrulama süreçlerini yönetmek ve güvenli bir şekilde erişim sağlamak amacıyla gerçekleştirilir. Aşağıda, C# kodları ile Microsoft Graph entegrasyonunu inceleyelim:

Yukarıdaki örnek, Microsoft Graph ile bir kullanıcının erişim belirteci (access token) almasını sağlar. Bu işlem, bir istemcinin (client) kimlik bilgileri ile güvenli bir şekilde yetkilendirilmesini sağlar. Kod içinde “Your_Client_Id”, “Your_Tenant_Id” ve “Your_Client_Secret” kısımları, kendi uygulamanızın bilgileriyle değiştirilmelidir.

Access Token ve Response JSON:

Access token, API hizmetlerine erişim sağlamak için kullanılır. Örneğin, RIVER platformundaki Microsoft ile entegre görev takibi özelliği için, bu token ile Microsoft Graph API’ye erişilebilir. Access token, API isteği başlıklarında kullanılarak istemcinin yetkilendirilmiş olduğunu doğrular.

Response JSON örneği:

Access token, “access_token” alanındaki uzun bir karakter dizisi olarak döner. Bu token, API isteği yaparken kullanılır ve istemcinin belirli bir süre boyunca yetkilendirildiğini doğrular. “expires_in” alanı, tokenin geçerlilik süresini saniye cinsinden belirtir. Access token, güvenlik katsayısını artırırken, kullanıcının belirli API hizmetlerine yetkilendirilmiş bir şekilde erişim sağlar. Bu sayede, RIVER platformu üzerindeki görev takibi gibi Microsoft ile entegre özellikler daha güvenli bir şekilde kullanılabilir.

Microsoft Graph çalışma mantığı için ilgili linke bakmanızı tavsiye ederim:
https://learn.microsoft.com/en-us/graph/auth-v2-user?tabs=http https://learn.microsoft.com/en-us/graph/traverse-the-graph?tabs=http

Microsoft Authentication Library (MSAL) Kullanımı (JavaScript)

Microsoft Authentication Library (MSAL), kullanıcıların ve uygulamaların Microsoft bulut hizmetlerine güvenli bir şekilde erişmelerini sağlayan bir kütüphanedir. MSAL, özellikle JavaScript ile uygulama geliştirenler için kullanıcı kimlik doğrulama işlemlerini kolaylaştırır. İşte MSAL kütüphanesinin JavaScript’te kullanımına dair örnek bir kod:

Yukarıdaki JavaScript kod örneğinde, MSAL kütüphanesi kullanılarak bir kullanıcının kimlik doğrulama süreci yönetilmekte ve başarılı bir kimlik doğrulama sonrasında access token alınmaktadır. Kod içinde “Your_Client_Id”, “Your_Tenant_Id”, ve “Your_Redirect_Uri” kısımları kendi uygulamanızın bilgileriyle değiştirilmelidir.

Bu örnekler, Microsoft Graph API’nin ve MSAL kütüphanesinin kullanımını anlatan temel bilgiler içermektedir. İhtiyacınıza göre bu örnekleri genişletebilir ve kullanıcıya özgü senaryolara uyarlayabilirsiniz.

MSAL kütüphanesinin çalışma mantığı için ilgili linke bakmanızı tavsiye ederim:
https://github.com/AzureAD/microsoft-authentication-library-for-js

 

Paylaş