Kuruluş Verileri: Microsoft Entra ID Uygulama Kaydı Oluşturma

Kuruluş verilerini (e-postalar, dosyalar, sohbetler ve takvim olayları) doğrudan özel uygulamalarınızla tümleştirerek kullanıcı üretkenliğini artırın. Microsoft Graph API'lerini ve Microsoft Entra Id'yi kullanarak, uygulamalarınızda ilgili verileri sorunsuz bir şekilde alıp görüntüleyerek kullanıcıların bağlam değiştirme gereksinimini azaltabilirsiniz. İster müşteriye gönderilen bir e-postaya başvuruyor, ister Teams iletisini gözden geçiriyor, ister bir dosyaya erişiyor olsun, kullanıcılar uygulamanızdan çıkmadan ihtiyaç duydukları bilgileri hızla bulabilir ve karar alma sürecini kolaylaştırabilir.

Bu alıştırmada şunları yapacaksınız:

• Microsoft Graph'ın kuruluş verilerine erişebilmesi ve uygulamaya ekleyebilmesi için bir Microsoft Entra ID uygulama kaydı oluşturun.
• Microsoft Teams'den belirli bir kanala sohbet iletileri göndermek için gereken ve team kimliklerini bulunchannel.
• Projenin .env dosyasını Microsoft Entra ID uygulama kaydınızdaki değerlerle güncelleştirin.

Microsoft Entra Id Uygulama Kaydı Oluşturma

1. Azure portalına gidin ve Microsoft Entra Id'yi seçin.

2. Yönet -->Uygulama kayıtları ve ardından + Yeni kayıt'ı seçin.

3. Yeni uygulama kayıt formu ayrıntılarını aşağıda gösterildiği gibi doldurun ve Kaydet'i seçin:

   • Ad: microsoft-graph-app
   • Desteklenen hesap türleri: Herhangi bir kuruluş dizinindeki hesaplar (Herhangi bir Microsoft Entra Id kiracısı - Çok Kiracılı)
   • Yönlendirme URI'si:
     • Tek sayfalı uygulama (SPA) öğesini seçin ve http://localhost:4200 alanına girin.
   • Uygulama kaydını oluşturmak için Kaydet'i seçin.

   

1. Kaynak menüsünde Genel Bakış'ı seçin ve değeri panonuza kopyalayın Application (client) ID .

   

Project'in .env Dosyasını Güncelleştirme

1. Düzenleyicinizde .env dosyasını açın ve değerini öğesine Application (client) IDatayınENTRAID_CLIENT_ID.

   ENTRAID_CLIENT_ID=<APPLICATION_CLIENT_ID_VALUE>
   

2. Uygulamadan Teams Kanalı'na ileti gönderebilme özelliğini etkinleştirmek isterseniz, Microsoft 365 geliştirme kiracı hesabınızı kullanarak Microsoft Teams'de oturum açın (bu, öğreticinin ön bölümlerinde belirtilmiştir).

3. Oturum açtıktan sonra ekibi genişletin ve uygulamadan ileti göndermek istediğiniz kanalı bulun. Örneğin, Şirket ekibini ve Genel kanalını (veya kullanmak istediğiniz ekibi/kanalı) seçebilirsiniz.

   

4. Ekip üst bilgisinde üç noktaya (...) tıklayın ve Ekip bağlantısı al'ı seçin.

5. Açılan pencerede görüntülenen bağlantıda ekip kimliği, sonrasındaki team/harf ve sayı dizesidir. Örneğin, "https://teams.microsoft.com/l/team/19%3ae9b9.../", ekip kimliği 19%3ae9b9... aşağıdaki / karaktere kadar.

6. Ekip kimliğini kopyalayın ve TEAM_ID dosyasında öğesine atayın.

7. Kanal üst bilgisinde üç noktaya (...) tıklayın ve Kanal bağlantısını al'ı seçin.

8. Açılan pencerede görüntülenen bağlantıda kanal kimliği, sonrasındaki channel/harf ve sayı dizesidir. Örneğin" bağlantısındahttps://teams.microsoft.com/l/channel/19%3aQK02.../" kanal kimliği 19%3aQK02... aşağıdaki / karaktere kadar.

9. Kanal kimliğini kopyalayın ve CHANNEL_ID dosyasında adresine atayın.

10. Devam etmeden önce env dosyasını kaydedin.

Uygulama ve API Sunucularını Başlatma/Yeniden Başlatma

Bu noktaya kadar tamamladığınız alıştırmalara göre aşağıdaki adımlardan birini gerçekleştirin:

• Önceki bir alıştırmada veritabanını, API sunucusunu ve web sunucusunu başlattıysanız, .env dosya değişikliklerini almak için API sunucusunu ve web sunucusunu durdurmanız ve yeniden başlatmanız gerekir. Veritabanını çalışır durumda bırakabilirsiniz.

  API sunucusunu ve web sunucusunu çalıştıran terminal pencerelerini bulun ve durdurmak için CTRL + C tuşlarına basın. Her terminal penceresine yazıp npm startEnter tuşuna basarak bunları yeniden başlatın. Sonraki alıştırmaya devam edin.

• Veritabanını, API sunucusunu ve web sunucusunu henüz başlatmadıysanız aşağıdaki adımları tamamlayın:

  1. Aşağıdaki adımlarda Visual Studio Code'da üç terminal penceresi oluşturacaksınız.

     

  2. Visual Studio Code dosya listesinde .env dosyasına sağ tıklayın ve Tümleşik Terminalde Aç'ı seçin. Devam etmeden önce terminalinizin projenin kökünde ( openai-acs-msgraph ) olduğundan emin olun.

  3. PostgreSQL veritabanını başlatmak için aşağıdaki seçeneklerden birini seçin:

     • Docker Desktop'ı yüklü ve çalışıyor durumdaysa terminal penceresinde çalıştırın docker-compose up ve Enter tuşuna basın.

     • Podman-compose yüklü ve çalışıyor podman varsa, terminal penceresinde komutunu çalıştırın podman-compose up ve Enter tuşuna basın.

     • PostgreSQL kapsayıcısını docker Desktop, Podman, nerdctl veya yüklediğiniz başka bir kapsayıcı çalışma zamanını kullanarak doğrudan çalıştırmak için terminal penceresinde aşağıdaki komutu çalıştırın:

       • Mac, Linux veya Linux için Windows Alt Sistemi (WSL):

         [docker | podman | nerdctl] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v $(pwd)/data:/var/lib/postgresql/data -p 5432:5432 postgres
         

       • PowerShell ile Windows:

         [docker | podman] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v ${PWD}/data:/var/lib/postgresql/data -p 5432:5432 postgres
         

  4. Veritabanı kapsayıcısı başlatıldıktan sonra, ikinci bir terminal penceresi oluşturmak için Visual Studio Code + simgeye basın.

     

  5. cd yazın ve bağımlılıkları yüklemek ve API sunucusunu başlatmak için aşağıdaki komutları çalıştırın.

     • npm install
     • npm start

  6. + Üçüncü bir terminal penceresi oluşturmak için Visual Studio Code Terminal araç çubuğundaki simgeye yeniden basın.

  7. cd ve aşağıdaki komutları çalıştırarak bağımlılıkları yükleyin ve web sunucusunu başlatın.

     • npm install
     • npm start

  8. Bir tarayıcı başlatılır ve adresine yönlendirilirsiniz http://localhost:4200.

     

Sonraki Adım

Kuruluş Verileri: Bir Kullanıcıda Oturum Açma ve Erişim Belirteci Alma