OAuth istemcileri oluşturma ve yönetme

OAuth kapsamları ve izinleri

OAuth kapsamları, OAuth istemci uygulamalarına verilen erişim düzeyini tanımlar. Örneğin, bir erişim belirteci kaynaklara tam erişime izin verebilir veya bunu salt okunur erişimle sınırlayabilir. Qlik Cloud içinde, kapsamlar istemcinin mevcut işlevselliğe ve kaynaklara erişimini kontrol eder. Kapsamlar olmadan istemciler hiçbir kaynağa erişemez.

Kullanılabilir OAuth kapsamları

Tablo, kullanılabilir kapsamları ve bunlarla ilişkili izinleri listeler:

OAuth istemcileri oluşturma

Kiracı yöneticileri, Yönetim etkinlik merkezindeki OAuth sayfasında OAuth istemcilerini yönetir. Bir OAuth istemcisi ile, kaynaklara güvenli bir şekilde erişmek için istemci uygulamanızı Qlik Cloud ile entegre edebilirsiniz.

Bir OAuth istemcisi oluşturma adımları

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.

2. Yeni oluştur'a tıklayın.

3. Bir istemci türü seçin:

   • Gizli istemciler için Web.

   • Genel istemciler için Tek sayfalı uygulama veya Yerel.

   • Genel istemciler için Anonim yerleştirme.

4. İletişim kutusunda, OAuth istemcisi için bir ad girin.

5. İsteğe bağlı olarak bir açıklama ekleyin.

6. Kaydırarak veya arama alanını kullanarak mevcut kapsamlardan herhangi birini seçin.

   İpucu notuTüm kapsamları veya yalnızca seçilenleri görüntülemek için Tümü ve Seçili düğmelerini kullanın.

7. OAuth istemci uygulaması için bir veya daha fazla yönlendirme URL'si girin (en fazla 5). Ardından yönlendirme URL'sini izin verilenler listesine eklemek için Ekle'ye tıklayın.

   • Yönlendirme URL'si, yetkilendirme sunucusunun başarıyla kimlik doğrulaması yaptıktan ve istemci uygulamasına izin verdikten sonra kullanıcının tarayıcısını gönderdiği yerdir. Örneğin, https://www.exampleapp.com/oauth/callback, burada /oauth/callback OAuth sağlayıcısından gelen kimlik doğrulama geri aramalarını işler.

   • Qlik Cloud, yalnızca URL'si yönlendirme URL'lerinin izin verilenler listesindeyse başarılı bir yetkilendirmeden sonra kullanıcıyı uygulamaya geri yönlendirecektir.

   • Etki alanı localhost olmadığı sürece URL'ler https:// ile başlamalıdır, bu durumda http:// ile başlayabilir. Yerel uygulamalar ayrıca uygulamaya özel bağlantı biçimini de kullanabilir, örneğin exampleapp://.

8. Web veya Tek sayfalı uygulama istemci türleri için bir veya daha fazla izin verilen köken belirtin (en fazla 5).

   • Uygulamaya erişim yalnızca URL izin verilen kökenler listesine eklenirse verilecektir.

9. Web istemci türü için, kullanıcı etkileşimi olmadan otomatik sistem erişimi için aşağıdaki seçeneklerden birini etkinleştirebilirsiniz:

   • Makineden Makineye (M2M) İzin Ver: Kullanıcı katılımı olmadan sistemden sisteme iletişimi etkinleştirir.

   • M2M kullanıcı kimliğine bürünmeye izin ver: Uygulamanızın kullanıcılar adına kimlik doğrulaması yapmasına ve kimlik doğrulama işlemi sırasında onlar gibi davranmasına olanak tanır.

10. Web istemci türü için, Kimlik doğrulama yöntemi altında bir veya her iki seçeneği belirleyin:

    • İstemci sırrı (varsayılan)

    • Özel anahtar JWT, istemcinin paylaşılan bir sır yerine genel/özel anahtar çifti kullanarak kimliğini doğrulayan daha güvenli bir seçenek.

      • Özel anahtar JWT seçeneğini belirlediğinizde, Genel anahtar alanı görünür. Üçüncü taraf uygulamanızın genel anahtarını JSON Web Anahtarı (JWK) biçiminde girin. Özel anahtar, JWT'leri imzalamak için uygulamanızda kalır. Genel anahtar biçimi hakkında daha fazla bilgi için Qlik Developer Portal'daki JWT'leri imzalamak için genel/özel anahtar çifti oluşturma bölümüne bakın.

        Bilgi notuGenel anahtar, kimlik sağlayıcınızın gereksinimlerine bağlıdır. Üçüncü taraf uygulamanızın genel anahtarı farklı bir biçimdeyse, onu JWK'ye dönüştürmek için üçüncü taraf bir araç kullanın.

11. Oluştur'a tıklayın.

12. İstemci kimliğini ve istemci sırrını daha sonra kullanmak üzere kaydetmek için Panoya kopyala'ya tıklayın. İstemci sırrını güvenli bir şekilde saklayın.

    Bilgi notuGenel istemcilerin bir istemci sırrı yoktur.

13. Bitti'ye tıklayın.

Belirli kullanım durumları için OAuth istemcileri

OAuth istemcisi kullanım durumları için aşağıdaki kaynaklara başvurun:

• Qlik Developer Portal'da OAuth'a Genel Bakış: OAuth kullanım durumlarına ve farklı OAuth türlerine genel bakış.

• Microsoft Office için Qlik eklentileri için OAuth istemcileri oluşturma: Microsoft Excel için Qlik eklentisinin kurulumu için bir OAuth istemcisi ayarlayın.

• Uygulama içeriğinin anonim yerleştirmeleri için bir OAuth istemcisi oluşturma: Gömülü uygulama içeriğine anonim erişim sağlamak için bir OAuth istemcisi oluşturun.

qlik-embed kullanarak anonim erişim için uygulama içeriğini yerleştirmek üzere, bu kullanım durumu için özel olarak tasarlanmış bir türe sahip bir OAuth istemcisi oluşturmanız gerekir.

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde, OAuth bölümüne gidin.

2. Yeni oluştur'a tıklayın.

3. İstemci türü açılır menüsünde Anonim yerleştirme'yi seçin.

4. OAuth istemcisi için bir Ad ve isteğe bağlı olarak bir Açıklama girin.

5. İzin verilen kökenler altında, yetkilendirmeniz gereken her kökeni girin. Bunlar, gömülü analitik bilgilerini almak için Qlik Cloud kiracısına erişecek olan etki alanlarıdır.

   Her URL'yi ekledikten sonra Ekle'ye tıklayın.

6. İşiniz bittiğinde Oluştur'a tıklayın.

7. İstemci kimliğini daha sonra kullanmak üzere kaydetmek için Panoya kopyala'ya tıklayın. Uygulama içeriği qlik-embed ile yerleştirildiğinde buna ihtiyaç duyulacaktır.

8. Bitti'ye tıklayın.

OAuth istemcilerini düzenleme

Bir OAuth istemcisini yeniden adlandırabilir, açıklamasını güncelleyebilir veya yönlendirme URL'lerini yönetebilirsiniz.

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.
2. Düzenlemek istediğiniz OAuth istemcisini bulun.
3. simgesine tıklayın ve ardından Düzenle'yi seçin.
4. OAuth istemcisi seçeneklerini gerektiği gibi değiştirin.
5. Kaydet'e tıklayın.

OAuth istemcilerini silme

Artık ihtiyaç duyulmadığında veya erişimi iptal etmek için bir OAuth istemcisini silebilirsiniz.

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.

2. Kaldırmak istediğiniz bir veya daha fazla OAuth istemcisini seçin ve ardından Sil'e tıklayın.

3. Silme işlemini onaylayın.

OAuth istemcilerini yayınlama

OAuth istemcileri başlangıçta onları oluşturan kiracıya bağlıdır. Ancak, bir OAuth istemcisini aynı bölgedeki birden fazla kiracı arasında paylaşılacak şekilde yapılandırabilirsiniz. Bu, üçüncü taraf uygulamaların farklı Qlik Cloud kiracıları arasında aynı istemci kimliğini kullanmasını sağlar.

Uygulama sahipleri, bir kiracı yöneticisi ile etkileşime girmeden sırları döndürebilir ve yapılandırmayı güncelleyebilir. Kiracı yöneticilerinin kimlik bilgilerini yönetmesine veya yayınlanan istemci için herhangi bir yapılandırma ayrıntısının farkında olmasına gerek yoktur.

Diğer kiracıların bir OAuth istemcisine bağlanmasına izin vermek için onu yayınlamanız gerekir.

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.
2. Yayınlamak istediğiniz OAuth istemcisini bulun.
3. İstemcinin yanındaki simgesine tıklayın ve Yayınla'yı seçin.
4. Onaylamak için Yayınla'ya tıklayın.

OAuth istemcisi yayınlandıktan sonra, diğer kiracılar tarafından harici kullanım için kullanılabilir hale gelir. Bir kullanıcı bu OAuth istemcisini kullanan harici bir web sitesini ziyaret ettiğinde, zaten etkin bir SaaS oturumu yoksa, kiracı ana bilgisayar adını ve kullanıcı kimlik bilgilerini girmesi istenecektir.

İlk oturum açma işlemi bir kiracı yöneticisinden onay gerektirecektir. Onaylandıktan sonra, OAuth istemcisi kiracının Yönetim etkinlik merkezinde görünecektir.

Onay yöntemleri

Varsayılan olarak, Qlik Cloud kimlik doğrulaması yaparken kullanıcılardan onay ister. Özellikle güvenilir uygulamalar için süreci kolaylaştırmak amacıyla, onay yöntemini onay istemini atlayan "Güvenilir" olarak ayarlayabilirsiniz.

Onay için iki seçenek vardır:

• Gerekli: OAuth istemcisi tarafından her yeni kapsam istendiğinde kullanıcıdan onay istenir. Bu yöntem, her erişim seviyesi için açık kullanıcı onayı sağlar.

• Güvenilir: Kullanıcıdan onay istenmez. Bu seçenek yalnızca yayınlanmamış istemciler için kullanılabilir. Yayınlanan istemciler için, birden fazla kiracı arasında güvenliği sağlamak amacıyla onay yöntemi her zaman Gerekli'dir.

Onay yöntemini değiştirme

Bir OAuth istemcisi için onay yöntemini değiştirmek üzere aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.
2. OAuth istemcisinde simgesine tıklayın ve Onay yöntemini değiştir'i seçin.
3. Gerekli veya Güvenilir'i seçin ve ardından Onay yöntemini değiştir'e tıklayın.

OAuth yapılandırmasını görüntüleme ve kopyalama

Yönetim etkinlik merkezinin OAuth bölümünde, Qlik Cloud kiracınızın kimlik doğrulama ayrıntılarını görüntülemek için OAuth yapılandırmasını görüntüle'yi seçin. Bu, OAuth uç noktaları ve ayarlarını içeren bir kod parçacığı ile harici uygulamalarda kullanmak üzere kopyalayabileceğiniz bir URL gösterecektir.

Bu yapılandırmayı Qlik Cloud'i üçüncü taraf uygulamalarla entegre etmek, API erişimini otomatikleştirmek veya gömülü analitikler için kimlik doğrulamasını yapılandırmak amacıyla kullanabilirsiniz.

İstemci sırlarını yönetme

Bir istemci sırrı tehlikeye girerse veya güvenlik politikanız periyodik güncellemeler gerektiriyorsa, sırları ekleyebilir veya kaldırabilirsiniz. Kesinti süresini önlemek için birden fazla istemci sırrı (en fazla 5) ekleyebilir, istemci uygulamanızı güncelleyebilir ve ardından eski sırrı kaldırabilirsiniz.

Bir istemci sırrı ekleme

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.
2. OAuth istemcisini bulun.
3. simgesine tıklayın ve Sırları yönet'i seçin.
4. Yeni bir istemci sırrı oluştur'a tıklayın.

5. İstemci sırrını ve istemci kimliğini kopyalayın ve güvenli bir şekilde saklayın.

   Bilgi notuİstemci sırrına daha sonra erişemeyeceksiniz.
6. Kapat'a tıklayın.

Bir istemci sırrını kaldırma

Aşağıdakileri yapın:

1. Yönetim etkinlik merkezinde OAuth bölümüne gidin.
2. OAuth istemcisini bulun.
3. simgesine tıklayın ve Sırları yönet'i seçin.
4. İstemci sırrının yanındaki simgesine tıklayın.
5. Kapat'a tıklayın.

Bir OAuth istemcisini Qlik Cloud ile kaydettikten sonra, Qlik Cloud içeriğine erişmek için OAuth istemci uygulamaları oluşturabilirsiniz. Uygulamanızda ilişkili istemci kimliğini ve istemci sırrını kullanın.

Adım adım rehberlik için Qlik Developer Portal'ın OAuth'a Genel Bakış bölümündeki eğitimlere bakın. Bu eğitimler, popüler programlama dillerini kullanarak istemci uygulamalarının nasıl oluşturulacağını kapsar.