دسته‌ها را مشاهده کنید

پیکربندی Azure SSO

مدت زمان مطالعه: : 5 دقیقه

TestRail به شما اجازه می‌دهد با استفاده از پروتکل‌های SAML ۲.۰، OAuth ۲.۰ و OpenID Connect، آن را به ارائه‌دهنده هویت SSO دلخواه خود، یعنی IDP، وصل کنید. بعد از فعال کردن تنظیمات SSO، می‌توانید پروتکل موردنظر خود را انتخاب کنید.
این راهنما به‌طور مشخص برای پیکربندی Azure است. برای ثبت web application مربوط به Azure AD و ثبت App در portal، ابتدا مراحل زیر را دنبال کنید:

  1. وارد Azure portal شوید و از credentials ادمین استفاده کنید.
  2. گزینه Azure Active Directory را انتخاب کنید.
  3. در Manage در نوار کناری سمت چپ، گزینه App registrations را انتخاب کنید. (تصویر نمونه در زیر آمده است)

  4. روی New Registration کلیک کنید:

  5. در بخش New Registration: 
    1. Name* – یک نام وارد کنید
    2. Supported account types – گزینه Appropriate Account types را انتخاب کنید
    3. Redirect URL – گزینه Web را انتخاب کنید (اگر از قبل انتخاب نشده است).
    4. Redirect URL (نباید خالی بماند) – Redirect URL را برای هدایت کاربر بعد از authorization وارد کنید. این URL باید همان مقداری باشد که در صفحه تنظیمات SSO برای OAuth و OpenID آمده است. Redirect URL را می‌توانید در صفحه پیکربندی SSO، زیر برچسب Single Sign On URL پیدا کنید.
      مثال: “http://${domain}/testrail/index.php?/auth/redirect_oidc_acs”
    5. روی Register کلیک کنید.
  6. اطلاعات تکمیلی را در تب Branding در بخش Manage اضافه کنید.
  7. در بخش Authentication ، در صورت نیاز URLهای اضافی ورود و خروج را تنظیم کنید.

  8. در بخش Certificates and Secrets: 

    1. ایجاد Secret – روی New Client Secret کلیک کنید.
    2. Description و زمان انقضا را وارد کنید – روی Add کلیک کنید.
    3. Client Secret – Client Secret همان Value است.

      #

    قبل از ترک این صفحه، مقدار Client Secret را کپی کنید؛ بعدا به آن نیاز دارید.

  9. در بخش Overview and Client ID ، زیر بخش Overview می‌توانید Client ID، Tenant ID و اطلاعات دیگر را پیدا کنید. در Overview ، Client ID را می‌بینید. 

      #

    Client ID و Tenant ID را کپی کنید؛ بعدا به آن‌ها نیاز دارید.

  10. برای اینکه کاربران به این app دسترسی داشته باشند، باید آن‌ها را در بخش Users اضافه کنید. 

      #

    سند مرجع را می‌توانید اینجا ببینید: https://docs.microsoft.com/en-us/graph/tutorials/php?WT.mc_id=Portal-Microsoft_AAD_RegisteredApps&tutorial-step=2

پیکربندی SSO در Azure – OpenID Connect #

  1. با حساب administrator وارد TestRail شوید.
  2. به مسیر Admin > Site Settings > SSO بروید.
  3. انتخاب کنید پروتکل احراز هویت: OpenID Connect.
  4. Single Sign On URL: این فیلد از قبل با مقادیری پر شده است که هنگام ثبت جدید application، برای تنظیم redirect URL استفاده می‌شوند.
  5. وارد Azure portal شوید و برای دریافت اطلاعات مراحل بعدی، به application خود دسترسی پیدا کنید.
  6. در TestRail، برای Client ID: مقدار Application (client) ID را از Azure و از تب Overview کپی کنید و در این فیلد قرار دهید.
  7. Client Secret: مقدار client secret Value را از Azure و از بخش Certificates and Secrets کپی کنید و در این فیلد قرار دهید.
  8. IDP Issuer URL: مقدار Directory (tenant) ID را از Azure و از تب Overview کپی کنید و این URL را کامل کنید: https://login.microsoftonline.com/${yourTenantId}/v2.0/
  9. Create Account on First Login: این گزینه را فعال کنید تا اگر کاربر با موفقیت احراز هویت شد، TestRail به‌صورت خودکار یک حساب کاربری جدید برای او ایجاد کند.
  10. Whitelist Domains: برای جلوگیری از درخواست‌های سازمان‌های غیرمجاز، می‌توانید ایجاد حساب جدید را به دامنه‌های ایمیل مشخص محدود کنید. در هر خط فقط یک دامنه وارد کنید. (اگر Whitelist Domain خالی باشد، به‌طور پیش‌فرض همه دامنه‌ها مجاز هستند.)
  11. روی Save Settings کلیک کنید.

پیکربندی SSO در Azure – OAuth ۲.۰ #

  1. با حساب administrator وارد TestRail شوید.
  2. به این مسیر بروید: Admin > Site Settings > SSO.
  3. گزینه Your Authentication Protocol: OAuth 2.0
  4. Single Sign On URL: این فیلد از قبل با مقادیری پر شده است که هنگام ثبت application جدید، برای تنظیم redirect URL استفاده می‌شوند (مرحله ۵ در بخش پیکربندی Azure SSO را ببینید).
  5. وارد Azure portal شوید و application خود را باز کنید تا اطلاعات موردنیاز مراحل بعدی را دریافت کنید.
  6. دوباره در TestRail، برای فیلد Client ID: مقدار Application (client) ID را از Azure، در تب Overview کپی کنید و در این قسمت قرار دهید.
  7. Client Secret: مقدار client secret یعنی Value را از Azure، در بخش Certificates and Secrets کپی کنید و در این قسمت قرار دهید.
  8. User Authorization URL: مقدار Tenant ID: مقدار Directory (tenant) ID را از Azure، در تب Overview کپی کنید و این URL را تکمیل کنید: https://login.microsoftonline.com/${yourTenantId}/oauth2/v2.0/authorize
  9. Access Token URL: مقدار Tenant ID: مقدار Directory (tenant) ID را از تب Overview در Azure کپی کنید و این URL را وارد کنید: https://login.microsoftonline.com/${yourTenantId}/oauth2/v2.0/token
  10. User Info URL: این URL را کپی کنید: https://graph.microsoft.com/oidc/userinfo و در این قسمت قرار دهید.
  11. Create Account on First Login: این گزینه را فعال کنید تا اگر کاربر با موفقیت احراز هویت شد، TestRail به‌صورت خودکار حساب کاربری جدیدی برای او ایجاد کند.
  12. Whitelist Domains: برای جلوگیری از درخواست‌های سازمان‌های غیرمجاز، می‌توانید ایجاد حساب‌های جدید را به دامنه‌های ایمیل مشخصی محدود کنید. در هر خط فقط یک دامنه وارد کنید. (اگر Whitelist Domain خالی باشد، به‌صورت پیش‌فرض همه دامنه‌ها مجاز هستند).
  13. روی Save Settings کلیک کنید.

پیکربندی SSO در Azure – SAML ۲.۰ #

  #

مهم: در Azure Portal باید SAML ToolKit را فعال کنید.

قبل از ادامه، مطمئن شوید مراحل این راهنما را کامل و درست انجام داده‌اید.

TestRail – URLهای SSO #

  1. به‌عنوان administrator وارد TestRail شوید.
  2. به مسیر Admin > Site Settings > SSO بروید.
  3. در بخش Your Authentication Protocol ، SAML 2.0 را انتخاب کنید.
  4. در بخش Entity ID ، این URL را برای استفاده در مراحل بعد کپی کنید.
  5. در بخش Single Sign On URL ، این URL را برای استفاده در مراحل بعد کپی کنید.
  6. گزینه Cancel را انتخاب کنید، چون فعلاً به تنظیمات بیشتری نیاز نیست.
  7. به بخش بعدی دستورالعمل‌ها بروید.

  #

Azure – پیکربندی SAML #

  1. وارد Azure portal شوید و به اپلیکیشن Azure AD SAML Toolkit دسترسی پیدا کنید.
  2. در سمت چپ صفحه، در بخش Manage ، گزینه Users and Groups را انتخاب کنید و کاربر یا کاربران موردنظر را اضافه کنید.
  3. به بخش Single sign-on بروید و SAML را انتخاب کنید.
  4. مقدار Login URL (SSO) را برای استفاده در مراحل بعد ذخیره کنید.
  5. مقدار Azure AD Identifier (Entity) URL را برای استفاده در مراحل بعد ذخیره کنید.
  6. فایل Certificate (Base64) را دانلود کنید، با یک text editor یا Notepad باز کنید و محتوای آن را برای استفاده در مراحل بعد ذخیره کنید.
  7. در بخش Basic SAML Configuration ، روی Edit کلیک کنید.
  8. در بخش Identifier (Entity ID) ، URL متادیتای Entity ID را از مرحله ۴ وارد کنید.
  9. در قسمت Reply URL (Assertion Consumer Service URL) ، URL متادیتای Entity ID را از مرحله ۴ وارد کنید.
  10. در قسمت Sign-on URL ، Single Sign-on URL را از مرحله ۵ وارد کنید و سپس ذخیره کنید.
  11. نیازی به پیکربندی دوباره mappingها نیست؛ گزینه‌های پیش‌فرض را بدون تغییر نگه دارید.
  12. به بخش Self Service بروید.
  13. گزینه Allow users to request access to this application? را فعال کنید.
  14. مجوزها را به گروه موردنظر بدهید.

  #

TestRail – پیکربندی SSO #

  1. با حساب administrator وارد TestRail شوید.
  2. به مسیر Admin > Site Settings > SSO بروید.
  3. روی radio button SSO Configuration Off/On کلیک کنید.
  4. در قسمت IDP SSO URL ، URL ارائه‌شده توسط Azure در مرحله ۱۱ را وارد کنید.
  5. در قسمت IDP Issuer URL ، URL ارائه‌شده توسط Azure در مرحله ۱۲ را وارد کنید.
  6. در قسمت IDP Certificate ، متن certificate ارائه‌شده توسط Azure را که در مرحله ۱۳ دریافت کردید وارد کنید.
  7. فعال کنید Authentication Fallback یا Create Account on First Login ، در صورت تمایل.
  8. روی Save Settings کلیک کنید.
به‌روزرسانی شده در ۱۴۰۵-۰۴-۱۷

احساسات شما چیست؟

  • خوشحال
  • عادی
  • ناراحت

دیدگاهتان را بنویسید