بازدان بۆ ناوەڕۆکی سەرەکی
هەموو بەڵگەنامەکان

پرۆتۆکۆلەکانی فیدەراسیۆن و دابینکردن

تەنها ئەو ڕووکارەکانی فیدەراسیۆن و دابینکردن هەڵبژێرە و بەکاربهێنە کە بۆ بەرنامە یان تەنەنتێک تۆمارکراون.

ڕەوتی کار
  1. ناسینەوەی ڕووکارچوونەژوورەوەی وێبگەڕ، ڕێگەپێدانی API، دابینکردنی directory و ئاڵوگۆڕی ئەجێنت لە یەک جیا بکەرەوە.
  2. پشکنینی تۆمارتەنەنت، ژیانی خزمەتگوزاری، مێتاداتای دابینکەر، redirect و پڕۆفایلی دڵنیاییی چالاک پشتڕاست بکەرەوە.
  3. ئاڵوگۆڕی بەهاکانمێتاداتای تۆمارکراو و گرێبەستی APIی بەڕێوەبردنی دروستکراو بەکاربهێنە.
  4. تاقیکردنەوەی هەڵسوکەوتناسنامە، نەخشە، ئەندامێتیی تەنەنت، چوونەدەرەوە یان دابینکردن بە ناسنامەی تاقیکردنەوە بپشکنە.
  5. پاراستنبڕوانامە بگۆڕە، هاوکاتکردن چاودێری بکە و تۆمارە کۆنەکان بە کۆنترۆڵی ژیانی خزمەتگوزاری ناچالاک بکە.

OIDC، OAuth و PKCE

کڕیاری OIDCی تۆمارکراو ڕێگەپێدانی وێبگەڕ، هەڵبژاردنی هەژمار، ڕەزامەندی و مەرجەکانی ڕێکخراو بەکاردەهێنێت. ڕێگەپێدانی ئامێر ڕووکارێکی جیاوازە و جێگرەوەی تۆمارکردنی کڕیار نییە. PKCE و هەڵبژاردەی دڵنیاییی بەرزتر بە سیاسەتی کڕیار و تەنەنتەوە دەبەسترێنەوە. PAR، private-key JWT، mTLS، DPoP و پڕۆفایلی FAPI مەرجدارن؛ بوونیان لە سەرچاوە واتای چالاکبوونیان نییە.

  1. دەرکەر، redirect و ڕێکخستنی وەڵامی ورد بۆ کڕیار تۆمار بکە.
  2. ڕەزامەندی و هەڵبژاردنی هەژمار تەواو بکە؛ ناسنامە و audience بپشکنە.
  3. پشتگیریی PKCE یان دڵنیایی لە سیاسەتدا پشتڕاست بکەرەوە؛ بۆ لابردنی ڕەتکردنەوە پشتڕاستکردنەوە لاواز مەکە.

SAML و چوونەدەرەوەی دوورەوە

ڕێڕەوی دابینکەری خزمەتگوزاری و ناسنامەی SAML مێتاداتا و ڕەوتی browser assertion پێشکەش دەکەن. پەیوەندییەکە لە ڕێگەی بەڕێوەبردنی SAML ڕێکبخە. دەرکەر، audience، شوێنی وەڵام، واژۆ و مەرجی کات لەگەڵ هاوبەش بسەلمێنە. چوونەدەرەوە جیاوازە: هەڵوەشاندنەوەی ناوخۆ نیشان نادات کە هەموو cookie یان دانیشتنی relying party پاککراوەتەوە.

  1. مێتاداتای پەیوەندی، کلیلی واژۆ و خاڵەکانی کۆتایی لەگەڵ هاوبەش بەراورد بکە.
  2. assertionێکی واژۆکراو تاقی بکەرەوە؛ تەنەنت، بابەت، ئەندامێتی و بەسەرچوون بسەلمێنە.
  3. کۆنترۆڵی چوونەدەرەوەی پشتگیریکراو بەکاربهێنە و هەڵوەشاندنەوەی ناوخۆ لە چوونەدەرەوەی دوورەوە جیا بکەرەوە.

SCIM و هاوکاتکردنی directory

دابینکردن لە فیدەراسیۆنی کارلێک‌پێکراو جیاوازە. سکیما و ئاشتکردنەوەی SCIM لەگەڵ پەیوەستکەرەکانی directory کاردەکەن کە ئەجێنتی لای کڕیاری تۆمارکراو بەکاردەهێنن. هاوردەکردن بنەچەی تەنەنت دەپارێزێت و ناکۆکییەکان دەخاتە قرنطین؛ ئیمەیڵ بە تەنها هەژمارەکان پەیوەست ناکات. سێرڤەر باینەری ئەجێنتی کڕیار دابین ناکات.

  1. ئامانجی تەنەنت تۆمار بکە و تایبەتمەندیی پشتگیریکراو و کلیلە نەگۆڕەکانی ناسنامە نەخشە بکە.
  2. هاوکاتکردنێکی کۆنترۆڵکراو جێبەجێ بکە؛ ئەنجامەکان بپشکنە و ناکۆکیی قرنطینکراو لە ڕەوتی تەنەنت چارەسەر بکە.
  3. پێش نۆرەکردنی کاری پەیوەستکەر، ئەجێنتی گونجاو بە جیا دابمەزرێنە و تۆماری بکە.

CAS، WS-Federation و RADIUS

CAS پێویستی بە چالاککردنی ڕوون هەیە. WS-Federation و WS-Trust ناچالاک دەمێننەوە، مەگەر تۆمار یان سیاسەتی ڕێگەپێدراو چالاکیان بکات؛ پشکنینی realm، audience، وەڵام، ئەندامێتی، واژۆ و بەسەرچوون پێویستە. RADIUS ئەجێنتێکی واژۆکراوی هەڵبژاردەیی بەکاردەهێنێت، نە گوێگرێکی ماڵپەڕ. ڕێنماییی پارێزراو RADIUS/1.1 لە ڕێگەی TLS یان DTLS پێشنیار دەکات؛ UDPی کۆن تەنها بۆ گونجاندنی تۆڕی تایبەتە.

  1. پێش تاقیکردنەوەی CAS یان WS-Federation، چالاکبوونی پرۆتۆکۆل و تۆمارکردنی کڕیار بپشکنە.
  2. بۆ RADIUS، ئەجێنتی کڕیار، پەیوەستکەری تەنەنت و گواستنەوەی ڕێگەپێدراو پشتڕاست بکەرەوە.
  3. ئەگەر ناچالاکە یان تۆمارنەکراوە، لەبری گۆڕینی پرۆتۆکۆل بۆ دەرچوون لە سیاسەت، ڕێکخستنەکە چارەسەر بکە.

تۆمارکردن و بڕوانامەکان

تۆمارکردنی کڕیار دەبێت لە ناو تەنەنت و بەرنامەی خاوەنداریدا بمێنێتەوە. تۆمارکردنی داینامیک، private-key JWT، mTLS و ئاماژە بە FAPI گرێبەستی مەرجدارن، نە چالاکبوونی گشتگیر. کلیلی تایبەت لە لای خاوەنەکەی بهێڵەوە و بە کۆنترۆڵی بەڕێوەبردنی پەیوەندیدار بیگۆڕە یان هەڵیبوەشێنەوە. کلیلی ئەجێنت بڕوانامەی کڕیاری OAuth نییە.

  1. خاوەن، تەنەنت، redirect یان مێتاداتا، مەودا و جۆری بڕوانامە کۆبکەرەوە.
  2. هەر نهێنییەکی وەرگیراو بە پارێزراوی هەڵبگرە؛ بە بەڕێوەبردن بیگۆڕە یان هەڵیبوەشێنەوە.
  3. بۆ تۆمارکردنی ئەجێنت، کلیلی تایبەت لە لای کڕیار دروست بکە و CSRی بنێرە.

گرێبەست و چارەسەرکردنی کێشە

بۆ کردار، خانە و ئاسایشی بەڕێوەبردنی ئێستا /api/auth/management/openapi.json بەکاربهێنە. تێبینیی پرۆتۆکۆلی پارێزراو هەڵسوکەوتی وردتری پەیوەستکەر و دڵنیایی دەگرێتەوە. هۆکاری باوی شکست بریتییە لە تەنەنتی هەڵە، redirectی تۆمارنەکراو، مێتاداتا یان بڕوانامەی کۆن، پڕۆفایلی ناچالاک، واژۆی نادروست، قرنطینی SCIM یان ئەجێنتی هەڵوەشێندراوە. سنووری متمانەی پەیوەندیدار چاک بکە؛ پشتڕاستکردنەوە ناچالاک مەکە.

  1. سکیما و پێداویستییە ئاسایشییەکانی کردار لە بەڵگەنامەی OpenAPI بپشکنە.
  2. وردەکاریی پارێزراوی هەڵە و بەها تۆمارکراوەکان لەگەڵ مێتاداتای ئێستای دابینکەر بەراورد بکە.
  3. ڕەوتی کۆنترۆڵکراو دووبارە تاقی بکەرەوە و پێش بڵاوکردنەوە دۆخی ناسنامە یان هاوکاتکردن بسەلمێنە.

پرسیارە باوەکان

ئایا بوونی DPoP یان FAPI واتای چالاکبوونیانە؟

نەخێر. پڕۆفایلی دڵنیاییی بەرزتر پێویستی بە چالاککردنی ڕوون و ڕێکخستنی تەواوی کڕیار هەیە.

ئایا ئەجێنتی لای کڕیار لە پاکێجدا هەیە؟

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

ئایا چوونەدەرەوەی SAML هەموو دانیشتنەکان پاک دەکاتەوە؟

نەخێر. هەڵوەشاندنەوەی ناوخۆ لە چوونەدەرەوەی دوورەوە و سڕینەوەی دانیشتنی لای هاوبەش جیاوازە.

ئایا SCIM دەتوانێت بە ئیمەیڵ بەکارهێنەر پەیوەست بکات؟

نەخێر. تەنەنت، دەرکەر و بابەتی نەگۆڕ نەخشە بکە؛ ناکۆکییەکان لە ڕێگەی پێداچوونەوەی قرنطین چارەسەر بکە.

ئایا دەتوانم RADIUS بە ڕاستەوخۆ دژی ماڵپەڕ بەکاربهێنم؟

نەخێر. RADIUS ڕووکاری ئەجێنتی واژۆکراوی هەڵبژاردەییە، نە خاڵی کۆتاییی وێبگەڕ.

خانە وردەکانی API لە کوێن؟

بەڵگەنامەی /api/auth/management/openapi.json بەکاربهێنە؛ نموونەکان گرێبەستی تەواوی SDK نین.

پەڕە پەیوەندیدارەکان