adım 2 (5)
2. Kimliği Doğrulanmış Toplayın ORCID kimlikler ve izinler
Bu adımda, Kimliği Doğrulanmış bir belgeyi nasıl alacağınızı öğrenin. iD ve veri okumak ve yazmak için gerekli izin ve ORCID kayıt.
ORCID entegrasyonlar “3 aşamalı OAuth” kullanıcıların kimliğini doğrulamak ve kayıtlarıyla etkileşim izni istemek için. ORCID üyeler, okuma ve yazma izinleri istemek için Üye API'sini kullanabilir.
Bu bölümde, Kimliği Doğrulanmış bir sertifika almak için kendi özel entegrasyonunuzun tamamlaması gereken adımları açıklayacağız. iD ve bir kişiye okuma ve yazma izni ORCID kayıt
Kimliği Doğrulanmış Alma iD ve bir kullanıcıdan kayıt erişim izni aşağıdakileri içerir OAuth 2.0, yetkilendirme için endüstri standardı bir protokol. OAuth, bir kullanıcının bir web sitesine veya uygulamaya, o siteye şifresini vermeden başka bir sitede depolanan hesap bilgilerine erişmesine izin verir.
Belirli bir site için kimlik bilgileriniz yerine Google veya Facebook'u kullanarak bir sitede oturum açtıysanız, OAuth'u zaten kullanmışsınız demektir!
OAuth işlemi 3 adım içerir:
- Bir yetkilendirme URL'si oluşturun
- Bir yetkilendirme kodu alın
- Bir erişim belirteci için yetkilendirme kodunu değiştirin
OAuth sürecini başlatmak için, kullanıcıları şuraya gönderen özel bir yetkilendirme URL'si oluşturmamız gerekecek: ORCID oturum açma ekranı. Bu URL şunlardan oluşur: Yetkilendirme bitiş noktası, Artı parametreler kuruluşunuzu ve talep etmek istediğiniz izinleri tanımlayan.
Parametre | Açıklama | Örnek E-posta |
---|---|---|
yanıt_türü | kod | |
kapsam | Listeden izin almak istediğiniz API işlemleri ORCID Kapsamları | /kişi/güncelleme /etkinlikler/güncelleme / okuma sınırlı /doğrula |
Müşteri Kimliği | Üye müşteriniz ID (veren kuruluş ORCID) | [UYGULAMA- ***] |
uri'yi yeniden yönlendir | Kullanıcıların yetkilendirme sürecini tamamladıktan sonra göreceği sayfa. (Bu eğitim için Google OAUth Playground olacaktır) | https://developers.go ogle.com/oauthplayground |
Faaliyetleri (bağlantılar, finansman, çalışmalar, akran değerlendirmesi, araştırma kaynakları) eklemek/güncellemek ve kişisel öğeler (diğer adlar, anahtar sözcükler, ülkeler, araştırmacı URL'leri, web siteleri ve kişisel harici tanımlayıcılar) eklemek/güncellemek için izin istemek ve okumak için ORCID kayıt, yetkilendirme URL'si şöyle olacaktır:
https://sandbox.orcid.org/oauth/authorize?client_id=[APP-****************]&response_type=code&scope=/read-limited%20/activities/update%20/person/update&redirect_uri=https://developers.google.com/oauthplayground
Ancak, yetkilendirme URL'sini oluşturmamıza yardımcı olması için Google OAuth oyun alanını kullanabiliriz.
- Kapsamlar alanına /activities/update, /person/update, /read-limited ekleyin ve API'leri Yetkilendir'e tıklayın.
Yetkilendirme URL'si, yapılandırma ve kapsam alanlarına girdiğiniz bilgiler kullanılarak oluşturulmuş olmalıdır.
- An ORCID oturum açma ekranı görünecektir; oluşturmak için kullandığınız e-posta adresi ve parola ile Sandbox hesabınızda oturum açın. ORCID Bu eğitimin başındaki hesap. Oturum açtıktan sonra, OAuth ekranı görünecektir. İstemci adı ve ilgili kapsamlar bu ekranda gösterilecektir. Erişim izni vermek için ' öğesini tıklamanız gerekir.Erişim yetkisi ver'
- İzin verdikten sonra, Sandbox kimlik bilgilerinizle ilişkili yönlendirme URI'sı olduğundan, Google OAuth Playground'a geri yönlendirileceksiniz. Tarayıcı adres çubuğundaki yönlendirme URI'sinin sonunda (ve 2. Adım google oauth oyun alanında sayfanın solundaki bölüm)
Secure https://developers.google.com/oauthplayground/code=s536Z5
Bir yetkilendirme kodunuz olduğunda, bunu bir erişim belirteci ve Kimliği Doğrulanmış iD İzin istediğiniz API eylem(ler)ini gerçekleştirmek için ihtiyaç duyacağınız, oturum açan kullanıcının.
Gerçek dünyadaki bir durumda, bu değişim PHP, Java veya Ruby on Rails gibi bir programlama dili kullanılarak sisteminiz tarafından yapılır. Bu eğitimde, bir web uygulamasını simüle etmek için Google OAuth Playground'u kullanacağız.
- Tıkla 'Belirteçler için yetkilendirme kodunu değiştirin'
Bir kez tıkladığınızda “Belirteçler için değişim yetkilendirme kodu” Erişim belirteciniz ve Kimliği Doğrulanmış iD içinde görünecek İstek/Yanıt sağdaki bölüm. Lütfen aşağıdaki örneğe bakın:
{
"name": "Sophia Garcia"
"access_token": "53737721-9cdb-442a-8b77-409609bb5e43",
"expires_in": 631138518,
"token type": "bearer",
"orcid":
"0000-0002-4456-8947"
"scope": "read-limited /activities/update person/update "
"refresh token": "cOfc38fd-291e-4633-a365-6f4afa304344"
}
- Bu jetonu kaydedin!
Onunla yapmanız gereken aramaları kolayca oluşturabileceğiniz için yukarıdaki adımda aldığınız belirteci kaydetmeniz önemlidir. Tam belirteç değişimi yanıtını saklamanızı öneririz.
Şimdi bir Kimliği Doğrulanmış topladınız ID ve kullanıcıdan bunları okuma izni ORCID kayıt edin ve güncelleyin ORCID kayıt.