الموارد · 43

التحقق من التكامل بين OAuth وOpenID Connect من البداية إلى النهاية.

فصل تسجيل الدخول، وتفويض الصلاحيات، وصلاحيات البيانات، ثم اختبار عمليات إعادة التوجيه، والرموز المميزة، والجلسات، والإلغاء.

مُحدَّث · 9 min

غرفة خيالية خالية للتحقق من الهوية فيها مفتاحا أمان وبطاقة فارغة وملف خمري رسم توضيحي تحريري مولّد بالذكاء الاصطناعي

ما يُساعد هذا الدليل على تحقيقه

  • فصل الهوية عن التفويض.
  • رفض عمليات إعادة التوجيه والرموز المميزة غير المقصودة.
  • اختبار حالات الرفض بدقة مماثلة لاختبار حالات النجاح.
  • التحقق من إزالة الوصول بعد المغادرة أو وقوع حادث.

فحص سريع

  • ما هو المزود والجهة المصدرة المتوقعان؟
  • هل تم تسجيل عنوان URI لإعادة التوجيه بدقة؟
  • هل يتم استخدام رمز الهوية بشكل خاطئ كرمز وصول؟
  • هل يتم التحقق من ملكية كل مورد؟
  • ما هي صلاحيات الوصول التي تبقى بعد الإلغاء؟

طريقة خطوة بخطوة

  1. 1

    رسم مخطط التدفق المنشور.

    تحديد العميل (عام أو سري)، والمتصفح، وخادم التفويض، وواجهة برمجة التطبيقات، ومزود OIDC. سجّل مسار الرموز والرموز المميزة، ومن يخزنها، والأدوار الممنوحة. لا يُحدد مخطط المبيعات عملية النشر الفعلية.

    المُخرَج: التدفق، وحدود الثقة، ومالكو المكونات.

  2. 2

    تحقق من عملية تسجيل الدخول.

    استخدم تدفق الرمز مع PKCE المناسب للعميل. تحقق من S256، وربط المعاملات، وعمليات إعادة التوجيه المسجلة، والحماية من الطلبات المُزوَّرة. اختبر عنوان URI غير متوقع، ومُدقِّق غير صحيح، ورمز مُعاد تشغيله، ومُصدر غير متوقع. يفصل RFC 9700 المتطلبات والتوصيات حسب نوع العميل.

    المُخرَج: نتائج الاختبارات المسموح بها والمرفوضة.

  3. 3

    تحقق من صحة الرمز المميز.

    يتحقق واجهة برمجة التطبيقات (API) من صحة رمز الوصول الخاص بها وفقًا لقواعد التنسيق والمزود: التوقيع أو الاستبطان، والمُصدر، والجمهور، وتاريخ الانتهاء، والأذونات. يتحقق عميل OIDC بشكل منفصل من رمز الهوية. لا يُثبت التوقيع الصحيح أن الرمز المميز ينتمي إلى واجهة برمجة التطبيقات هذه.

    المُخرَج: عقد التحقق واختبارات الجمهور وانتهاء الصلاحية.

  4. 4

    التحقق من صلاحيات العمل.

    اختبار كائن مملوك لحساب آخر، ودور أدنى، وحقل خاص، وعملية إدارية. لا يُغني نطاق الوصول أو بوابة المصادقة عن عمليات التحقق من جانب الخادم على المورد المطلوب. استخدم حسابات وبيانات اختبار مُصرَّح بها.

    المُخرَج: مصفوفة الدور والكائن والعملية والرفض المتوقع.

  5. 5

    اختبار انتهاء الصلاحية والإلغاء.

    فصل الجلسة المحلية، وجلسة المزوّد، ورمز الوصول، ورمز التحديث. اختبار المغادرة، وفقدان الجهاز، وتغيير الدور، وتدوير مفتاح التوقيع، وانقطاع المزوّد. توثيق وقت الوصول المتبقي بدلاً من افتراض أن تسجيل الخروج يُلغي كل شيء فورًا.

    المُخرَج: الجدول الزمني لإزالة الوصول والاستثناءات.

  6. 6

    المراقبة دون الكشف عن الأسرار.

    تسجيل مرجع المعاملة، وقرار التحقق، وفئة الخطأ، وإصدار التكوين. استبعاد الرموز والرموز المميزة والأسرار. إعداد التشخيص، وإيقاف التكامل، والرجوع إلى التكوين المُعتمد؛ إعادة تشغيل الاختبارات بعد تغييرات الموفر. مخرجات

    المخرج: إجراءات التشغيل وفحوصات التراجع.

مثال عملي افتراضي

حالة توضيحية

مثال توضيحي: عميلان يستخدمان مزوّد هوية واحد. يتم تقديم رمز صالح للعميل الأول إلى واجهة برمجة تطبيقات العميل الثاني.

القرار والأدلة المتوقعة

ترفض واجهة برمجة التطبيقات الجمهور غير الصحيح، وتسجّل مسارًا بدون رمز، ولا تُرجع أي بيانات. يصبح الرفض اختبارًا للتراجع.

تمييز الآليات

الآليةالغرضالتحقق أو التقييد
OAuth 2.0تفويض الوصول إلى المواردأذونات الكائنات من جانب الخادم
OpenID Connectالتحقق من الهوية من خلال رمز هوية مُدقَّقالتحقق من المُصدر والجمهور والمعاملة
جلسة التطبيقالحفاظ على تسجيل دخول التطبيقانتهاء الصلاحية والإبطال وحماية الجلسة

مؤشرات الإدارة

المؤشرما يقيسهالإجراء الأول
تصحيح حالات الرفضالحالات المحظورة التي تم حظرها بالفعلإصلاح كل قبول غير متوقع
تأخير الإلغاءالوقت حتى اختفاء الوصول ذي الصلةالتحقق من الجلسات والرموز بشكل منفصل
حالات فشل التحققحالات الرفض حسب السبب والإصدارفصل الهجمات عن أخطاء التكوين

الأخطاء الشائعة

  • الخلط بين المصادقة والتفويض
  • قبول أي جمهور بعد التحقق من التوقيع
  • تسجيل إعادة توجيه واسعة النطاق معرّفات الموارد الموحدة (URIs)
  • تسجيل الرموز لتسهيل تصحيح الأخطاء

الأسئلة المتكررة

هل يحلّ PKCE محلّ جميع عناصر التحكم؟

لا. فهو يحمي تبادل الرموز في المسار المقصود؛ ولا يزال التحقق من صحة الرمز، وعمليات إعادة التوجيه، وتفويض الأعمال، والجلسات بحاجة إلى فحص.

هل يُعدّ JWT إذنًا؟

JWT هو تنسيق. لا تصبح المطالبات قابلة للاستخدام إلا بعد التحقق من صحتها وتطبيق قواعد واجهة برمجة التطبيقات (API).

هل يجب بناء التحقق من الصحة من الصفر؟

يُفضّل استخدام مكتبة مُحدّثة ووثائق مزوّد الخدمة، ثم اختبار التكوين. قد يتم تكوين مكتبة صحيحة بشكل خاطئ.

ما الأدلة التي يجب حفظها لتحقق مفيد؟

احتفظ بسياق الحساب والأدوار والمورد وردود API. نجاح الدخول لا يثبت صحة صلاحيات كل مورد؛ لا تسجل أسرار الجلسة.

OAuth/OIDC: الجمهور والصلاحيات

الملاحظات المرجعية المفصّلة متاحة باللغة الإنجليزية في هذه النسخة.

Which token belongs to which recipient? A testable validation contract

A secure OAuth/OIDC integration connects each token to its purpose, issuer and intended recipient. An ID token tells the OIDC client about authentication; an access token is presented to a protected resource. Successful sign-in alone does not authorise a read, a change or an AI agent’s tool call.

This reference covers a specific profile: an API consuming JWT access tokens under RFC 9068. OAuth 2.0 does not require every access token to use JWT. Clients must treat their access tokens as opaque; the resource server owns the validation contract. The examples below are fictional, with no secret or usable signature.

Where codes and tokens belong
Where codes and tokens belong Four independent rows show the recipients: code to token endpoint, ID token to OIDC client, access token to API, refresh token to token endpoint. This is not the full exchange sequence. Code → Token endpoint Transaction-bound exchange ID token → OIDC client Identity and client_id audience Access token → API / resource Check audience and permissions Refresh token → Token endpoint Renewal, not an API call Distinct destinations · conceptual map, not a network sequence

Four objects with distinct purposes

Four objects with distinct purposes
ObjectRecipient and purposeBoundary to retain
Authorisation codeAuthorisation server token endpoint: redeem the code within the intended transaction.The code is not an API permission; check binding to the client, redirect and PKCE.
ID tokenOIDC client: validate identity and transaction; aud contains its client_id.Do not reuse it as an API access credential; apply the OIDC rules for the relevant flow.
Access tokenResource server: access within the grant; its audience identifies the intended resource.Validate the token, then operation and object permissions. The client must not depend on its internal content.
Refresh tokenAuthorisation server token endpoint: obtain new access tokens.Do not send it to the resource server; its lifecycle differs from the local session.

Eight controls for the validation contract

Eight controls for the validation contract
ControlRule and scopeEvidence without tokens
Profile and typFor RFC 9068, check typ = at+jwt or application/at+jwt. Other profiles need their own rules; “any signed JWT” is too broad a contract.Configured profile and a rejected ID/access token confusion case.
Algorithm and keysVerify the signature with the expected issuer’s keys and algorithms allowed by configuration. RFC 9068 excludes alg = none; a received value does not set policy by itself.Cryptographic policy version and result, with no secret material.
Issuer issCompare exactly with the expected issuer. A similar host, path or suffix does not establish trust.Configuration reference and issuer_mismatch reason.
Audience audThe expected recipient must appear in aud. An audience array is possible; finding the recipient does not replace other checks.Expected resource and a test using a token intended for another API.
Expiry expCurrent time must precede exp; any small clock leeway is an explicit policy. The teaching fixture uses zero seconds of leeway.Test clock, configured leeway and an exercised expiry boundary.
Scopes and objectBind each scope to the resource and operation. Then check ownership, tenant and business policy on the server. RFC 9068 does not define all this authorisation.Action, test object, applied rule and a cross-tenant denial.
OIDC transaction and PKCEIf nonce was sent, verify its presence and equality in the ID token. RFC 9700 requires PKCE for public clients and recommends it for confidential clients; bind the challenge to the transaction, with S256 recommended.Wrong nonce, replayed code and wrong code_verifier tests in the authorised flow.
Access lifetime and removalSeparate access-token expiry, renewal and application session. RFC 9700 requires sender constraint or rotation to detect refresh-token replay for public clients.Residual access timeline, user departure and an exercised revocation procedure.
Read fictional claims without treating them as proof

Teaching clock: 2026-10-22 at 10:00:00 UTC. The JSON contains a readable header and claims only; no signed JWT serialization is supplied. exp is 10:05:00 UTC and iat is 09:59:00 UTC. The .example domains and identifiers belong solely to this scenario.

{
    "header": {
        "typ": "at+jwt",
        "alg": "RS256",
        "kid": "training-key-01"
    },
    "claims": {
        "iss": "https://identity.example/",
        "sub": "training-subject-17",
        "aud": "https://api.example/evidence",
        "exp": 1792663500,
        "iat": 1792663140,
        "jti": "training-event-001",
        "client_id": "training-console",
        "scope": "evidence:read"
    }
}

Decoding JSON does not validate a signature or establish trust in keys. Where stated, cryptography is an exercise assumption, never a check performed by this page. The profile also has required claims including sub, client_id, iat and jti: the eight-control table is not a complete validator. A subject does not necessarily identify a person; jti alone does not implement replay protection.

Ten review cases: decision, limit and expected evidence

01 · Token intended for the API: continue to business checks

Situation: iss, aud, typ and exp match the fictional contract; evidence:read is present. Signature verification is assumed solely for the exercise.

Decision: continue to operation and object checks, without automatically declaring “access allowed”. Expected evidence: business rule and test object reviewed separately.

02 · Assumed correct signature, wrong audience

Change: aud targets https://api.example/billing rather than the evidence resource. Other assumptions remain the same.

Decision: reject this token for this API. A correct signature does not change its recipient. Expected evidence: no resource content returned and a token-free audience failure record.

03 · Different issuer with plausible claims

Change: iss is https://other-identity.example/. An HTTPS URL does not make it equivalent to the configured issuer.

Decision: reject the issuer match. Expected evidence: exact comparison with https://identity.example/ and a regression test.

04 · Expiry reached at the exact second

Change: exp equals the test clock, 10:00:00 UTC, with zero seconds of leeway in this fixture.

Decision: reject as expired. “Now is before exp” is false at equality; this example does not establish a universal clock policy. Expected evidence: tests before, at and after the boundary under the real policy.

05 · ID token presented as an access token

Change: a fictional ID token has typ = JWT and aud = training-console. It targets the OIDC client.

Decision: reject it as an RFC 9068 JWT access token. Validating it at the OIDC client does not turn it into an access token. Expected evidence: separate validation rules for each token type.

06 · Write scope presented for a read operation

Change: scope is evidence:write while the call requires evidence:read.

Decision: deny the read under the exercise policy, which defines no write → read implication. Scope names and relationships belong to the contract. Expected evidence: an explicit operation/scope matrix, without inferring permissions from names.

07 · Readable JSON, unverified cryptography

Situation: the JSON is readable and values appear to match, but cryptographic validation and trusted keys are not established.

Decision: stop acceptance; the state is unverified. Expected evidence: configured library output and trust-contract checks. Reading claims alone must not release protected data.

08 · Correct token, another tenant’s object

Situation: test token checks are assumed to pass. The requested object belongs to another tenant and business policy denies this read.

Decision: deny the object. evidence:read does not grant access to every account’s evidence. Expected evidence: server-side cross-tenant test and no leakage through content or returned fields.

09 · Audience array containing the expected resource

Change: aud contains https://api.example/evidence and https://api.example/archive. The expected resource is listed.

Decision: this audience check can pass; continue all other checks. An array is not a wildcard. Expected evidence: scopes remain meaningful for the resource, with no ambiguous grant.

10 · ID token nonce differs from the transaction

Separate OIDC transaction, outside the API cases: sent nonce = training-transaction-A; received nonce = training-transaction-B.

Decision: reject the ID token for this transaction under OIDC Core §3.1.3.7. This does not replace PKCE or API rules. Expected evidence: compare with the original transaction and test missing nonce when one was sent.

Six useful acceptance-review records

  • Map clients, issuers, APIs and expected audiences, with an owner for each boundary.
  • Versioned validation contract: format, libraries, trusted keys, algorithms and clock leeway.
  • Action, scope, tenant and object matrix; state denials and the permission implications actually defined.
  • Synthetic fixtures, a fixed clock, negative variants and observed results in the authorised environment.
  • Separate session, access-token and refresh-token timelines during departure, revocation and provider outage.
  • Redacted log: internal transaction reference, policy version, decision reason and date; exclude tokens, codes and secrets.

Primary sources and reading scope

Sources reviewed on

المراجع الرسمية

تدعم المراجع الطريقة. قم بتكييف عمليات التحقق مع سياقك؛ فهي ليست شهادة. قد تكون عناوين المراجع الأصلية والوثائق المصدرية بلغة أخرى.

تاريخ مراجعة المراجع .