> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# OIDC

> إعداد مصادقة OpenID Connect

قم بتكوين Gorbit مع مصادقة OpenID Connect (OIDC).
متوفر مع مزودي الهوية الشائعين مثل Okta و Microsoft Entra ID (Azure AD).

سيرشدك هذا الدليل خلال عملية الإعداد لـ Okta. سيكون لمزودي الهوية الآخرين عملية مشابهة.
يرجى التواصل معنا إذا كنت بحاجة إلى مساعدة مع مزود هوية مختلف.

## الدليل

<Steps>
  <Step title="إنشاء تطبيق Okta">
    انتقل إلى **Admin Console** في Okta → **Applications** → **Create App Integration**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/oidc_create_integration.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=44d1a9fc52ca2e86cbc0bf79f61a6f1f" alt="Okta Create Integration Page" width="2544" height="822" data-path="assets/deployment/oidc_create_integration.png" />
  </Step>

  <Step title="تكوين تطبيق Okta">
    اختر **OIDC** و **Web Application**.

    سمِّ تطبيقك `Gorbit`.

    <Tip>
      إذا كنت تستخدم علامة Gorbit التجارية الخاصة بك، يمكنك تسمية تطبيقك بحرية.
    </Tip>

    أضف **Sign-in redirect URI**

    ```
    https://YOUR_GORBIT_DOMAIN.com/auth/oidc/callback
    ```

    حدد ما إذا كان جميع المستخدمين أو مجموعات محددة يمكنهم الوصول إلى Gorbit أو تخطى هذه الخطوة وتعيين المستخدمين لاحقًا.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/oidc_config.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=97dcfa48d4c0dfe4d0c182c4fb014012" alt="Okta Configure OIDC Application Page" width="2148" height="1302" data-path="assets/deployment/oidc_config.png" />
  </Step>

  <Step title="حفظ بيانات اعتماد OIDC">
    أنشئ التطبيق الجديد واحفظ **Client ID** و **Client Secret**.

    أيضًا سجّل **Okta Base URL** بالتنسيق `https://<YOUR_ORG_NAME>.okta.com`.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/oidc_secrets.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=f7d30e044fb2f3c7c51da35ea4268b00" alt="Okta OIDC Credentials Page" width="2316" height="1656" data-path="assets/deployment/oidc_secrets.png" />

    <Note>
      بعد حفظ تطبيقك،
      يمكنك تحميل شعار Gorbit أو شعارك المخصص بالنقر على أيقونة الترس بجانب عنوان التطبيق **Gorbit**
    </Note>
  </Step>

  <Step title="تكوين Gorbit لـ OIDC">
    قم بتكوين Gorbit مع متغيرات البيئة التالية في ملف `.env` أو `values.yaml` (Docker و Kubernetes،
    على التوالي).

    ```bash .env theme={null}
    AUTH_TYPE=oidc
    OAUTH_CLIENT_ID=<CLIENT_ID_FROM_OKTA>
    OAUTH_CLIENT_SECRET=<CLIENT_SECRET_FROM_OKTA>
    OPENID_CONFIG_URL=https://<YOUR_OKTA_BASE_URL>/.well-known/openid-configuration
    ```

    <Note>
      إذا كنت تستخدم Docker ولكن ليس لديك ملف `.env`،
      انسخ `gorbit/deployment/docker_compose/env.prod.template` إلى ملف `.env` جديد في نفس المجلد.
    </Note>

    ```bash values.yaml theme={null}
    auth:
       secrets:
          OAUTH_CLIENT_ID: <CLIENT_ID_FROM_OKTA>
          OAUTH_CLIENT_SECRET:<CLIENT_SECRET_FROM_OKTA>
    configMap:
       AUTH_TYPE: oidc
       OPENID_CONFIG_URL: https://<YOUR_OKTA_BASE_URL>/.well-known/openid-configuration
    ```
  </Step>
</Steps>