هێمای تاک لەسەر/چوونەژوورەوە

ئێف بی ئای دوو ژینگە پێشکەش دەکات: لم و بەرهەمهێنان. سندوقی لم هەمان ڕێکخستنی هەیە وەک ژینگەی بەرهەمهێنان، بەڵام تەرخانکراوە بۆ مەبەستی یەکخستن.

پێویستە دەستگەیشتنت هەبێت بە ژینگەکەمان بۆ تێکەڵبوون لەگەڵ کرداری چوونەژوورەوە لەگەڵ کرداری FIB کە پێویستت بەم وردەکاریانەی خوارەوە دەبێت:client_id ,client_secret ,SSL Certificate .

تێبینی

ئێستاPay with FIB بریتیە لەoffline جۆری پارەدان. لە داهاتوودا بەرز دەکرێتەوە بۆonline جۆر لەگەڵ بژاردەی تەواو کە پەیوەندی بەم جۆرەوە هەیە.

پێویستە هاوبەشەکە بە سەرکەوتوویی فۆرمی تۆمارکردن پڕ بکات و پابەندی ڕێنماییەکانی وەڵامدانەوە بێت:

1. پێویستە هاوبەش بڕوانامەی ئێس ئێس ئێڵ دابنێت؛
2. هاوبەش پێویستە به‌تنی چوونەژوورەوە بە به‌تنی FIB لەسەر ماڵپەڕەکەی دابنێت (تاگی HTML لە لایەن FIB دابینکراوە دوای تۆمارکردن)؛
3. پێویستە هاوبەش خاڵی کۆتایی پێشکەش بکات بۆ وەرگرتنی authorization_code لە FIB - بەپێی تایبەتمەندییەکانی OAuth2.

یەکەم: تکایە کۆمپانیاکەت وەک هاوبەش تۆمار بکە.

ژینگەی ئێمە تەنها بە بڕوانامەی SSL بەردەستە. ئێمە بڕوانامەیەکی تایبەت بە SSL ئامادە دەکەین بۆ کۆمپانیاکەت و ئێمە پێکەوە لەگەڵ ClientId و ClientSecret پێشکەشتان دەکەین دوای تۆمارکردنی سەرکەوتوو. لەگەڵ گەیشتن بە ژینگە، هەموو به‌تنه‌كانی FIB و گرافیک دەست دەکەوێت.

تکایە بڕوانامەی SSL لەسەر ئامێرەکانتان دابنێن.

ئەگەر پێشتر دەستت بە ژینگەکەمان گەیشتوە، ئەوا تکایە زیاتر بەردەوام بە، ئەم هەنگاوانەی خوارەوە جێبەجێ بکە.

ئەگەر پێویستت بە وردەکاری زیاتر بوو، تکایە پەیوەندیمان پێوە بکە بە پڕکردنەوەی فۆرمی داواکاری یەکخستنی FIB و لە خۆگرتنی پرسیارەکانت لە بەشی وردەکاری.

بۆ ئەوەی بتوانیت بەناوی ئەوەوە دەستت بگات بە زانیارییەکانی بەکارهێنەر، پێویستە لیستی تۆکنەکان بەدەستبهێنیت (access_token له‌گه‌ڵ id_token ). لەم بەشەدا باسی چۆنیەتی ئەنجامدانی دەکەین.

ئێمە بە تەواوی پابەندین بە OIDC.

OIDC چەندین لێشاو پێناسە دەکات بۆ بەدەستهێنانی چوونەژوورەوەی یاسایی. لە FIB ئێمە کۆدی ڕێپێدان بەکاردەهێنین.

هێڵکارییەکە لە خوارەوە نیشان دەدرێت.

هەنگاوی یەکەم: چوونەژوورەوە

مەرجی پێشوەختە بۆ ئەم قۆناغە زیادکردنی به‌تنی چوونه‌ژووره‌وه‌یه‌ له‌گه‌ڵ FIB  بۆ لاپەڕەی چوونەژوورەوەت. ئەو به‌تنه‌ پێویستە دوای ناو تۆمارکردن وەک هاوبەش بۆت بنێردرێت.
بۆ دەستپێکردنی پرۆسەی چوونەژوورەوە تکایە ئەم داواکارییە بنێرە.

GET /auth/realms/fib-personal-application/protocol/openid-connect/auth?response_type=code&client_id={client_id}&scope=openid&redirect_uri={redirect_uri}

response_type : پێویستە. پێویستە بنێردرێت بۆcode .

client_id : پێویستە. ئه‌وclient_id پێویستە دوای تۆمارکردنی سەرکەوتوو وەک هاوبەشێک بۆت دابین بکرێت.

scope : ئارەزوومەندانە. ئێمە تەنها پشتگیری دەکەینopenid مەودا. ئەگەر پرسیار دەربارەی مەودای جیاواز بکەیت، ئەوا داواکارییەکەت ڕەت دەکرێتەوە.

redirect_uri : ئاره‌زوومه‌ندانه‌یه‌. لە کوێauthorization_code دەنێردرێت . ئەم بەهایە دەبێت بگونجێت لەگەڵ یەکێک لە بەهاکان کە دابینکراوە لەکاتی تۆمارکردنی هاوبەشەکەت.

state : ئاره‌زوومه‌ندانه‌.

ئەگەر داواکارییەکە ڕاست بوو، ئەوا لاپەڕەی چوونەژوورەوەی FIB بۆ بەکارهێنەر پیشان دەدرێت. بەکارهێنەر پێویستە بڕوانامەی گونجاو بنووسێت، واتە ژمارەی تەلەفۆن و وشەی نهێنی.

بەکارهێنەر دەتوانێت كلیك لەسەرBack to Partner button . پاشان ئاڕاستە دەکرێتەوە بۆ ماڵپەڕەکەت. ئەگەر بەکارهێنەر کلیک لەسەر...Login به‌تن، ئەوا دوو سیناریۆی جیاواز ئەگەری هەیە:

ئەگەر ئەمە یەکەم چوونەژوورەوە بێت، ئەوا پەڕەی ڕەزامەندی بۆ بەکارهێنەر پیشان دەدرێت.

بەکارهێنەر دەتوانێت بڕیار بدات یان نەیکات دەستڕاگەیشتن بە زانیارییە کەسییەکانی خۆی.
ئەگەر بەکارهێنەر ڕێگەی دەستڕاگەیشتن بدات، ئەواauthorization_code ده نێردرێت بۆredirect_uri . تکایە هەنگاوەکانی دواتر ← هەنگاوی دووەم.
ئەگەر بەکارهێنەر ڕێگە بە چوونە ژورەوە نەدات، ئەوا وەڵامەکە دەنێردرێت بۆredirect_uri پەیامی هەڵە وەک پارامیتەر

[your_redirect_uri]/redirect?error=access_denied

لە حاڵەتی دووبارەبوونەوەی پرۆسەی چوونەژوورەوە، شاشەی ڕەزامەندی چیتر پیشان نادرێت وauthorization_code ده نێردرێت بۆredirect_uri دوای چوونە ژوورەوە. تکایە هەنگاوەکانی دواتر ← هەنگاوی دووەم.

هەنگاوی دووەم: گۆڕینی کۆدی ڕێگەپێدان بە تۆکنه‌كان

ئه‌وauthorization_code بۆ ئەو بەستەرەی کە لە یەکەم داواکاری تۆدا دابینکراوە وەکredirect_uri پارامیتەر.

تکایە چارەسەر بکەauthorization_code بەدروستی. بەم شێوەی خوارەوە بۆتان دەنێردرێت.

[your_redirect_uri]/?code=8b874631-335c-4ea1-ab0f-16f09b6d30bb.c5969e06-35c2-407a-b14c-27ed110fe1a2.4c39f090-0257-41c2-ab53-4227a8a3deac

وەک دەبیننauthorization_code زنجیره‌، دەتوانیت بەکاری بهێنیت بۆ ئاڵوگۆڕی بە تۆکن. بۆ ئەنجامدانی، تکایە ئەم داواکارییە بنێرن.

POST /auth/realms/fib-personal-application/protocol/openid-connect/token
HTTP/1.1 Content-Type: application/x-www-form-urlencoded
client_id=[your_client_id]
&client_secret=[your_client_secret]
&grant_type=authorization_code
&code=[authorization_code]
&redirect_uri=[redirect_uri]

client_id : پێویستە. ئه‌وclient_id پێویستە دوای تۆمارکردنی سەرکەوتوو وەک هاوبەشێک بۆت دابین بکرێت.

client_secret : پێویستە. ئه‌وclient_secret پێویستە دابینکەر بێت بۆ تۆ دوای تۆمارکردنی سەرکەوتوو وەک هاوبەش.

grant_type : پێویستە. پێویستە ئامادە بکرێت بۆauthorization_code .

code : پێویستە. ئه‌وauthorization_code لە بەشی سەرەوە وەرگیراوە.

redirect_uri : پێویستە. ئەم بەهایە دەبێت بگونجێت لەگەڵ یەکێک لە بەهاکان کە دابینکراوە لەکاتی تۆمارکردنی هاوبەشەکەت.

ئەگەر داواکارییەکی گونجاو بنێریت، FIB SSO وەڵامێکت بۆ دەنێرێت لەگەڵ لیستی نیشانەکان. تکایە هەنگاوەکانی دواتر → هەنگاوی سێیەم

هەنگاوی سێیەم: کۆدی ID Token

ئەگەر بە سەرکەوتوویی کۆدەکە لادەیتid_token پێویستە پێکهاتەی ڕاستەقینەی ببینیت.

{
  "exp": 1596529813,
  "iat": 1596529513,
  "auth_time": 1596529503,
  "jti": "465fb2cd-d04e-480e-a94e-974fc5c05a4e",
  "iss": "https://keycloak.stage.azure.lawrence-spring.com/auth/realms/fib-personal-application",
  "aud": "sso-client-mock",
  "sub": "6a0b445a-b42c-4739-a65c-d669332bc1a9",
  "typ": "ID",
  "azp": "sso-client-mock",
  "nonce": "Kqxg9IcNjjSjmKN1qmXB0t60rWPAtafnK8bvumzYpeY",
  "session_state": "e573d23c-7a2d-499f-a043-5a16468f06f6",
  "acr": "0",
  "phone_number": "+48666605805",
  "given_name": "Piotr",
  "family_name": "Jasiński"
}

کۆدکراوەID token ئەم زانیاریانەی خوارەوە لەخۆ دەگرێت دەربارەی بەکارهێنەر:
ناسنامەی تایبەتی بەکارهێنەر - بەردەستە لە ژێرsub > کێڵگە؛
ناوی یەکەم - بەردەستە لە ژێرgiven_name کێڵگە؛
ناوی کۆتایی - بەردەستە لە ژێرfamily_name کێڵگە؛
ژمارەی مۆبایل - بەردەستە لە ژێرphone_number بوار. بوار.

لە ڕوانگەی FIB هیچ جیاوازییەک نییە لە نێوان چونه‌ژووره‌وه‌ له‌گه‌ڵ FIB و خۆ تۆماركردنی FIB. ئێمە هەردوو به‌تنی ( چوونەژوورەوە و خۆ تۆمارکردن) دوای ناو تۆمارکردن وەک هاوبەش دابین دەکەین. تکایە بڕیار بدە چۆن دەتەوێت جێبەجێی بکەیت:
یەک به‌تن بەکاربهێنە بۆ چوونەژوورەوە و بۆ خۆ تۆمارکردن (تۆمارکردنەکە لە پشت دیمه‌نه‌كه‌ ئەنجام دەدرێت)؛
دوو به‌تنی جیاواز بەکاربهێنە: یەکێکیان بۆ چوونەژوورەوە، دووەمیان بۆ خۆ تۆمارکردن.

هەرچۆنێک بێت، بۆ تۆمارکردنی بەکارهێنەری نوێ تکایە زانیاری بەکاربهێنە لەid_token . ئەگەر کۆدەکە لێک بدەیتەوەid_token (وەک لە سەرەوە خراوەتەڕوو)، ئەوا پێویستە بدۆزیتەوەsub بوار. بوار. تاکە ناسنامەی بەکارهێنەرە. تکایە تێبینی ئەوە بکە کەid_token ته‌نها له‌و كاته‌ ده‌گه‌ڕێته‌وه‌ ئه‌گه‌ر داوای بكه‌ی ..openid مەودا.

ناسینەوە بەکاربێنە لەsub بوار  بۆ تۆمارکردنی بەکارهێنەر لە بنکەدراوەی خۆتدا. ئەگەر بەکارهێنەر هەوڵیدا جارێکی تر ناوی خۆی تۆمار بکات، دەتوانیت ئەو بوارە بەکاربهێنیت بۆ ئەوەی بزانیت کە ئایا پێشتر لە بنکەدراوەی تۆدا بوونی هەیە یان نا. بەم پێیە بۆ کارایی چوونەژوورەوە دەتوانیت پشتڕاستی بکەیتەوە کە ئایا بەکارهێنەرەکە لە بنکەدراوەی تۆدا بوونی هەیە یان نا، و ئەگەر نەبوو دەتوانیت تۆماری بکەیت یان هەڵەیەک فڕێ بدەیت.

ناسێنەری تاکە کەسی بەکارهێنەر ()sub هەرگیز ناگۆڕێت.

FIB سێ جۆر تۆكن پێشکەش دەکات:

access_token

refresh_token

id_token

چوونە ژورەوەی تۆکن

گەیشتن بە تۆکن بەشێکە لە لێشاوی پرۆتۆکۆلی OAuth2.0.
لە FIB بریتییە لە JWS (JWT) لەگەڵ ئیمزا.

نموونەaccess_token بەم شێوەیەی خوارەوە دیارە

{

"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJPdjBsNEJGOVRmVDlWNTEtVjZBeTRmYlVoQ0dMbTZXUVpxcXQ4S3lLOGhnIn0.eyJleHAiOjE1OTY1Mjk4MTMsImlhdCI6MTU5NjUyOTUxMywiYXV0aF90aW1lIjoxNTk2NTI5NTAzLCJqdGkiOiI3YTU2MWUzNC1jNjk4LTRhYzMtYmQyYS05ODQyMTA0NmM3NjIiLCJpc3MiOiJodHRwczovL2tleWNsb2FrLmRldi5henVyZS5sYXdyZW5jZS1zcHJpbmcuY29tL2F1dGgvcmVhbG1zL2ZpYi1wZXJzb25hbC1hcHBsaWNhdGlvbiIsInN1YiI6IjZhMGI0NDVhLWI0MmMtNDczOS1hNjVjLWQ2NjkzMzJiYzFhOSIsInR5cCI6IkJlYXJlciIsImF6cCI6InNzby1jbGllbnQtbW9jayIsIm5vbmNlIjoiS3F4ZzlJY05qalNqbUtOMXFtWEIwdDYwcldQQXRhZm5LOGJ2dW16WXBlWSIsInNlc3Npb25fc3RhdGUiOiJlNTczZDIzYy03YTJkLTQ5OWYtYTA0My01YTE2NDY4ZjA2ZjYiLCJhY3IiOiIwIiwic2NvcGUiOiJvcGVuaWQifQ.Ds_k_CTm9jNm2jc7khADyBWzaj0HvX8_ieefl6p_9lzFuRdKhC8SSLNxde_JHoHX9AG9VHylVHM0MtoRDTiv2J0uEd8LQOZ4EuPCb6SVm4oah3bjZtL8D5gdhiL0fP114MY5oTKFFW_Mv-681Vd6acyUVYqBKG_vrsSYkkX_NNmj-_Gq6WM5AKS4PdqHvrPdZcn5KAoq0Y7WvhOseM2hq11KE8NUBpkRQRdc3rIYRfeRjDulKSswOozg7-e9FmT9rBw2Cb65Hx3kYl-SDROaTWZjYfiHLaiVTU7luxPy4Et-fd6_axrutp139yoq1dR3kzF-q-y1-AX0HSziDUekig"

}

نوێکردنەوەی تۆکن

نوێکردنەوەی تۆکن بەشێکە لە لێشاوی پرۆتۆکۆلی OAuth 2.0.
هەروەها بابه‌تی JWS ە (هەمان شتە کە...access_token ).
تکایە بەکاری بهێنە بۆ وەرگرتنی یەکێکی نوێaccess_token ئه‌گه‌ر ئه‌وکاته‌ی ئێستا کۆتایی پێبێت تکایە شوێنی OAuth2.0 بکەوە، لە حاڵەتی ئەوەی کە ئێستا بەسەرچووە. تکایە شوێنی OAuth2.0 بکەوە

نموونەیەک refresh_token بەم شێوەیەی خوارەوەیە.

{

"refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJPdjBsNEJGOVRmVDlWNTEtVjZBeTRmYlVoQ0dMbTZXUVpxcXQ4S3lLOGhnIn0.eyJleHAiOjE1OTY1Mjk4MTMsImlhdCI6MTU5NjUyOTUxMywiYXV0aF90aW1lIjoxNTk2NTI5NTAzLCJqdGkiOiI3YTU2MWUzNC1jNjk4LTRhYzMtYmQyYS05ODQyMTA0NmM3NjIiLCJpc3MiOiJodHRwczovL2tleWNsb2FrLmRldi5henVyZS5sYXdyZW5jZS1zcHJpbmcuY29tL2F1dGgvcmVhbG1zL2ZpYi1wZXJzb25hbC1hcHBsaWNhdGlvbiIsInN1YiI6IjZhMGI0NDVhLWI0MmMtNDczOS1hNjVjLWQ2NjkzMzJiYzFhOSIsInR5cCI6IkJlYXJlciIsImF6cCI6InNzby1jbGllbnQtbW9jayIsIm5vbmNlIjoiS3F4ZzlJY05qalNqbUtOMXFtWEIwdDYwcldQQXRhZm5LOGJ2dW16WXBlWSIsInNlc3Npb25fc3RhdGUiOiJlNTczZDIzYy03YTJkLTQ5OWYtYTA0My01YTE2NDY4ZjA2ZjYiLCJhY3IiOiIwIiwic2NvcGUiOiJvcGVuaWQifQ.Ds_k_CTm9jNm2jc7khADyBWzaj0HvX8_ieefl6p_9lzFuRdKhC8SSLNxde_JHoHX9AG9VHylVHM0MtoRDTiv2J0uEd8LQOZ4EuPCb6SVm4oah3bjZtL8D5gdhiL0fP114MY5oTKFFW_Mv-681Vd6acyUVYqBKG_vrsSYkkX_NNmj-_Gq6WM5AKS4PdqHvrPdZcn5KAoq0Y7WvhOseM2hq11KE8NUBpkRQRdc3rIYRfeRjDulKSswOozg7-e9FmT9rBw2Cb65Hx3kYl-SDROaTWZjYfiHLaiVTU7luxPy4Et-fd6_axrutp139yoq1dR3kzF-q-y1-AX0HSziDUekig"

}

ID Token

ID Token بەشێکە لە OpenID Connect Core 1.0.
ئەمە بابەتی JWSە.
تکایە بەکاری بهێنە بۆ وەرگرتنی زانیاری دەربارەی بەکارهێنەر.

نموونەid_token بەم شێوەیەی خوارەوە دیارە

{

"id_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJPdjBsNEJGOVRmVDlWNTEtVjZBeTRmYlVoQ0dMbTZXUVpxcXQ4S3lLOGhnIn0.eyJleHAiOjE1OTY1Mjk4MTMsImlhdCI6MTU5NjUyOTUxMywiYXV0aF90aW1lIjoxNTk2NTI5NTAzLCJqdGkiOiI3YTU2MWUzNC1jNjk4LTRhYzMtYmQyYS05ODQyMTA0NmM3NjIiLCJpc3MiOiJodHRwczovL2tleWNsb2FrLmRldi5henVyZS5sYXdyZW5jZS1zcHJpbmcuY29tL2F1dGgvcmVhbG1zL2ZpYi1wZXJzb25hbC1hcHBsaWNhdGlvbiIsInN1YiI6IjZhMGI0NDVhLWI0MmMtNDczOS1hNjVjLWQ2NjkzMzJiYzFhOSIsInR5cCI6IkJlYXJlciIsImF6cCI6InNzby1jbGllbnQtbW9jayIsIm5vbmNlIjoiS3F4ZzlJY05qalNqbUtOMXFtWEIwdDYwcldQQXRhZm5LOGJ2dW16WXBlWSIsInNlc3Npb25fc3RhdGUiOiJlNTczZDIzYy03YTJkLTQ5OWYtYTA0My01YTE2NDY4ZjA2ZjYiLCJhY3IiOiIwIiwic2NvcGUiOiJvcGVuaWQifQ.Ds_k_CTm9jNm2jc7khADyBWzaj0HvX8_ieefl6p_9lzFuRdKhC8SSLNxde_JHoHX9AG9VHylVHM0MtoRDTiv2J0uEd8LQOZ4EuPCb6SVm4oah3bjZtL8D5gdhiL0fP114MY5oTKFFW_Mv-681Vd6acyUVYqBKG_vrsSYkkX_NNmj-_Gq6WM5AKS4PdqHvrPdZcn5KAoq0Y7WvhOseM2hq11KE8NUBpkRQRdc3rIYRfeRjDulKSswOozg7-e9FmT9rBw2Cb65Hx3kYl-SDROaTWZjYfiHLaiVTU7luxPy4Et-fd6_axrutp139yoq1dR3kzF-q-y1-AX0HSziDUekig"

}

بۆ چوونەژورەوە دەتوانیت ئەم بەستەرەی خوارەوە بەکاربهێنیت.

[env_url]/auth/realms/fib-personal-application/protocol/openid-connect/logout

پێویستە ڕێنماییەکان لە کاتی دیزاینکردنی به‌تنی چوونەژوورەوە لەسەر شاشەی هاوبەش لە بیر بکرێت
ڕێنماییەکان دابەزێنە بە بەکارهێنانی ئەم لینکەی خوارەوە.