Eylem Düzeyi Kapsamları Yönetme
Her entegrasyon için ajan'ın istediği OAuth kapsamlarını kontrol edin, yeni eylemleri yönetin ve erişim durumunu inceleyin.
Her entegrasyon için ajan'ın istediği OAuth kapsamlarını kontrol edin, çalışma alanınızda yeni eylemlerin ne zaman etkinleştirileceğini yönetin ve her eylemin erişim durumunu inceleyin.
Çalışma alanınızda hangi entegrasyon eylemlerinin etkin olduğunu ve kullanıcılar bağlanırken ajan'ın hangi OAuth kapsamlarını isteyebileceğini kontrol edin. Eylem erişimini incelemek, özel bir OAuth istemcisi hazırlamak veya bir eylemin neden Missing scope gösterdiğini anlamak istediğinizde bu sayfayı kullanın.
Kapsamlar eylemleri nasıl kontrol eder
Her entegrasyon eyleminin bağlı sağlayıcıdan bir veya daha fazla OAuth kapsamına ihtiyacı vardır. Örneğin bir Outlook Calendar eyleminin takvim etkinlikleri oluşturmadan veya güncellemeden önce Calendars.ReadWrite gerekebilir.
ajan eylemleri ihtiyaç duydukları kapsamlara göre gruplar. Bir eylemi etkinleştirdiğinizde veya kapattığınızda ajan'ın OAuth sağlayıcıdan istediği kapsamları da değiştirebilirsiniz. Yeni bir bağlantı için seçilen OAuth istemcisi, istenen bu kapsamların nasıl yönetileceğini belirler.
Farklı OAuth İstemcilerinin entegrasyonunuzun kullanılabilir kapsamlarını nasıl yönetebileceğini karşılaştırmak için aşağıdaki tabloyu kullanın.
| Mod | Kapsam davranışı |
|---|---|
| ajan Client | ajan istenen kapsamları etkin veya paylaşılan eylemlerle senkron tutar. |
| Scope sync on | Seçilen özel OAuth istemcisi aynı otomatik kapsam senkron davranışını kullanır. |
| Scope sync off | Seçilen özel OAuth istemcisi elle yönettiğiniz Fixed scopes kullanır. |
Yeni eylemleri kontrol etme
Integrations settings içinde, ajan mevcut bir entegrasyona eylem eklediğinde ne olacağını kontrol eden New actions enabled by default ayarını bulabilirsiniz.
ajan, yeni bağlantı için OAuth istemcisinin eylemin gerekli kapsamlarını zaten kapsayıp kapsamadığını kontrol eder.
- Gerekli kapsamları kapsanan eylemler otomatik etkinleştirilir.
- Eksik kapsamlı eylemler gerekli kapsamları ekleyene veya senkronize edene kadar kapalı kalır.
Yeni eylemler siz inceleyip etkinleştirene kadar kapalı kalır.
Aynı kural ajan mevcut bir eyleme kapsam eklediğinde de geçerlidir. Yeni bir kapsam ajan'ın sağlayıcınızdan isteyebileceklerini sessizce genişletmez.
Bir OAuth istemci modu seçin
Entegrasyonları kullanırken ajan Client'ı veya Kendi OAuth İstemcinizi Getirin seçeneklerinden birini kullanabilirsiniz. Integrations settings içinde yerleşik bir entegrasyon seçin ve o entegrasyon için OAuth istemci modunu yapılandırmak üzere Scopes and Action Access bölümüne kaydırın.
OAuth kapsamlarını ajan'ın sizin için yönetmesini istediğinizde ajan Client kullanın. Bu, ajan'ın yönetimli OAuth istemcisi sağladığı entegrasyonlarda Multi-Tenant Cloud üzerinde varsayılandır.
ajan kullanıcıyı tanımlamak için gereken openid, email ve offline_access gibi auth kapsamlarını ister. Ayrıca herkese açık veya belirli kullanıcı ve gruplarla paylaşılan eylemlerin gerektirdiği kapsamları da ister.
Kapsamları elle düzenlemezsiniz. İstenen kapsamları değiştirmek için eylemleri etkinleştirin, kapatın veya paylaşın.
Kapsam durumunu inceleme
Aktif istenen kümenin parçası olan kapsamları görmek için Scope view kullanın. Yeşil onaylı kapsam grupları istenir. Kırmızı X'li kapsam grupları istenmez.
Eylemleri tek tek yönetmek için Action view kullanın. Bu görünüm bir eylemi aramak, etkin duruma göre sıralamak veya belirli bir eylemin ihtiyaç duyduğu kapsamları kontrol etmek için kullanışlıdır.
Bir eylem şu anda istenmeyen bir kapsama ihtiyaç duyuyorsa Missing scope rozetinin üzerine gelin. ajan Client ile eylemi etkinleştirmek, değişikliği onayladıktan sonra o kapsamı istenen kapsamlara ekler.
Kapsam güncellemelerini onaylama
Değişikliğiniz bir kapsam eklediğinde veya kaldırdığında ajan, istenen kapsamları güncellemeden önce bir onay iletişim kutusu gösterir. Onayladıktan sonra yeni verilen kapsamanın kullanılabilir olması için kullanıcıların bağlantılarını yenilemesi gerekir.
Mevcut bağlantılar, kullanıcılar bağlantıyı yenileyene veya erişim token'ları süresi dolana kadar verilen kapsamlarını korur.
Eylem erişimini yönetme
Her eylem tüm kullanıcılara açık olabilir veya belirli kullanıcı ve gruplarla paylaşılabilir. Bir entegrasyonu ve eylemlerini kimlerin kullanabileceğini kontrol etmek için Eylem Erişimini Yönetme sayfasına bakın.
Bu modda ne değişir
| Değişiklik | Sonuç |
|---|---|
| Enable an action | The action is enabled. Missing scopes are added after you confirm. |
| Disable an action | The action is disabled. Scopes are removed if no other enabled or shared action needs them. |
| ajan adds an action whose required scopes are covered | The action follows New actions enabled by default. |
| ajan adds an action with missing scopes | The action stays disabled until you enable it and confirm the scope change. |
| ajan adds a scope to an existing action | The action keeps its current state. The scope is requested only if an enabled or shared action needs it. |
Çalışma alanınız ayrılmış bir dağıtımda çalışıyorsa veya izin ekranında kendi markanızı, kiracı politikalarınızı ve hız sınırlarınızı istiyorsanız özel OAuth istemcileri kullanın.
Kurulum adımları için Kendi OAuth İstemcinizi Getirin sayfasına bakın.
Each custom client stores its own scopes and Sync scopes with enabled actions setting. Open the settings icon on the client card you want to configure. The setting applies to new connections that select that client and to existing connections when they reauthorize through it.
Kapsamları etkin eylemlerle senkronize etme
Özel OAuth istemcisinin ajan Client gibi davranmasını istediğinizde Sync scopes with enabled actions öğesini açın. ajan auth kapsamlarını artı etkin veya paylaşılan eylemlerin gerektirdiği kapsamları ister.
Özellikle ajan Client kullanılamadığı için kendi OAuth istemcinize ihtiyaç duyuyorsanız bu önerilen kurulumdur. Bu durumda ajan yine istenen kapsamları minimal ve etkin eylemlerinizle güncel tutar.
Sync scopes with enabled actions öğesini kapattığınızda o istemci için istenen kapsamları kendiniz yönetirsiniz. ajan'ın önerilen kapsamlarını sabit liste olarak kullanabilir veya kendi kurulumunuz için özel kapsamlar tanımlayabilirsiniz.
Fixed scopes kullanma
İstenen kapsamları kendiniz yönetmek istediğinizde Sync scopes with enabled actions öğesini kapatın. OAuth istemcisi Fixed scopes moduna geçer ve Scopes alanı gerçek kaynak olur.
Önerilen varsayılanlara sıfırlamak, tam listeyi kopyalamak veya kapsamları elle düzenlemek için kapsam haplarının yanındaki kontrolleri kullanın.
Fixed scopes, güvenlik ekibiniz OAuth kapsamlarını eylem erişiminden ayrı inceliyorsa veya istenen kapsamların eylem değişiklikleri boyunca sabit kalmasını istiyorsanız kullanışlıdır.
Fixed scopes ile eylemleri yönetme
ajan yine her eylemi seçilen özel OAuth istemcisinin istediği kapsamlara karşı kontrol eder.
- Scope configured, eylemin gerekli kapsamlarının istemcinizde dahil olduğu anlamına gelir. Eylemi normal şekilde etkinleştirebilirsiniz.
- Missing scope, en az bir gerekli kapsamın istemcinizde olmadığı anlamına gelir.
Hangi kapsamların eklenmesi gerektiğini görmek için Missing scope üzerine gelin. Araç ipucu, eksik kapsamlar önceden doldurulmuş OAuth istemci iletişim kutusunu açan Add it to your OAuth client configuration içerir.
Eksik kapsamlı eylemleri onaylama
Eksik kapsamlı bir eylemi etkinleştirirseniz ajan önce onay ister. Eylem etkin görünebilir ancak eksik kapsamlar OAuth istemcisine eklenene kadar çalışmaz.
Özel kapsamlarla çalışma
Bazı çalışma alanları ajan varsayılanlarından farklı kapsamlar ister. Yaygın bir Microsoft örneği, SharePoint için Sites.ReadWrite.All yerine Sites.Selected kullanmaktır; böylece ajan yalnızca seçili sitelere erişebilir. Etkilenen eylemler ve seçili site sınırlamaları için Microsoft entegrasyon kapsamları sayfasına bakın.
ajan eylemleri bildirdikleri kapsamlara karşı karşılaştırır. Bir eylem Sites.ReadWrite.All bildiriyorsa, Sites.Selected kiracınızda eyleme yeterli erişim verse bile Missing scope gösterebilir.
Özel kapsamları kullanmak için:
Fixed scopes'a geçin
Özel istemci kartındaki ayarlar simgesini açın, Sync scopes with enabled actions öğesini kapatın ve ajan'ın o istemci üzerinden istemesini istediğiniz kesin kapsamları girin.
Yeni eylemleri varsayılan olarak kapatın
Manage built-in integrations içinde New actions enabled by default öğesini kapatın.
Eylemleri manuel etkinleştirin
Özel kapsamlarınızla çalıştığını onayladıktan sonra her eylemi etkinleştirin.
Her sürümü inceleyin
ajan eylem eklediğinde özel kapsamlarınızla çalışıp çalışamayacağını inceleyin. İncelemeyi OAuth istemci yöneticinizle paylaşmak için Export scope configuration CSV'sini kullanın.
Bu modda ne değişir
| Change | Result |
|---|---|
| Enable an action with configured scopes | The action is enabled. The requested scopes do not change. |
| Enable an action with missing scopes and scope sync on | ajan adds the missing scopes to the requested scopes after you confirm. |
| Enable an action with missing scopes and Fixed scopes | The action can be enabled after confirmation, but it may not run unless your custom scopes provide the required access. Review this before enabling the action for users. |
| Add a scope to the OAuth client | Actions that need the scope can now be enabled and run. |
| Remove a scope from the OAuth client | Actions that need the scope show Missing scope. They remain enabled, but fail to run until you add it back or confirm that your custom scopes provide the required access. |
| ajan adds an action with configured scopes and scope sync on | The action follows New actions enabled by default. |
| ajan adds an action with configured scopes and Fixed scopes | The action stays disabled until you review and enable it. |
| ajan adds an action with missing scopes | The action stays disabled until you add the scope and enable it, or until you enable it manually after confirming that your custom scopes provide the required access. |
Fixed scopes ile New actions enabled by default kapalı kullanın. Yeni eylemler kapsamlarını incelemeden önce etkin görünmez.
Native eylemler
Native eylemler temel ajan özelliklerini güçlendirir ve her zaman etkindir.
Native eylemler şunları destekler:
- Sohbet ve Temsilcilerde entegrasyonlardan dosya ekleri.
- Klasör senkronizasyonu.
- Company Knowledge.
- Entegrasyonlardan senkronize edilen ekler için erişim kontrolleri.
- Eylem çağrıları ve İş Akışlarında kimlikleri kaynak adlarına çözümleme.
ajan Client veya Sync scopes with enabled actions açık özel OAuth istemcisi kullandığınızda native eylem kapsamları istenen kapsamlardan kaldırılamaz. Fixed scopes kullanan özel bir OAuth istemcisiyle ajan'ın native eylemler için gereken kapsamları istemediği bir kurulum yapılandırabilirsiniz.
Native eylemler için gereken kapsamları istememek yukarıda listelenen özelliklerde platform işlevselliğini bozabilir. Sohbet, Temsilciler veya İş Akışlarında doğrudan entegrasyon kullanımının ötesinde kullanıcı deneyimini de etkileyebilir.
Kapsam yapılandırmasını dışa aktarma
Geçerli eylem ve kapsam yapılandırmasının CSV'sini indirmek için Export scope configuration düğmesine tıklayın.
Dışa aktarım her eylemin adını, açıklamasını, gerekli kapsamlarını, etkin durumunu ve paylaşım yapılandırmasını içerir. Entegrasyon erişimini güvenlik ekibinizle veya OAuth sağlayıcınızı yöneten yöneticiyle incelemeniz gerektiğinde kullanın.
SSS
The action is disabled when New actions enabled by default is off in the integration settings, or when the OAuth client selected for new connections does not request all scopes required by the action.
You can manually enable the action based on your OAuth setup. This may add permissions to the requested scopes. If you use Fixed scopes, add the missing scopes to your OAuth client first.
To enable future actions automatically when all required scopes are already part of the OAuth client, turn New actions enabled by default on.
The toggle only appears for custom OAuth clients. The ajan Client always syncs scopes with enabled and shared actions.
Existing connections keep the scopes granted at connection time. After you add a scope, users need to refresh their connection before the new scope is granted.
Open the settings icon on the custom client card that applies to the affected users. Confirm that the scope is listed there and as an API permission in your Azure app registration. If admin consent is required, confirm that it has been granted.
Yes. Turn New actions enabled by default off. Existing actions keep their current state. Future actions are disabled until you review them.
Yes. A workspace can activate one client for the entire workspace and additional clients for specific groups. Each client keeps its own scope list and scope sync setting.
With the ajan Client or a custom OAuth client with Sync scopes with enabled actions turned on, ajan removes a scope only when no enabled or shared action needs it. Auth scopes such as offline_access and openid are always requested.
With Fixed scopes, ajan never changes the requested scopes automatically.
İlgili sayfalar
- Kendi OAuth İstemcinizi Getirin — Bir entegrasyon için özel OAuth uygulaması kurun.
- Integrations settings — Çalışma alanınızda eylem erişimini inceleyin.
- Microsoft — Microsoft entegrasyonları için kiracı geneli yönetici onayı verin.
- Entegrasyonlar Kılavuzu — Entegrasyonların ajan'da nasıl çalıştığını öğrenin.