برای رمزگذاری سمت کلاینت به ارائه دهنده هویت خود متصل شوید

با اتصال IdP خود، می‌توانید CSE را برای همه برنامه‌های وب پشتیبانی‌شده Google Workspace تنظیم کنید:

• گوگل درایو
• اسناد گوگل
• صفحات گوگل
• اسلایدهای گوگل
• جیمیل
• تقویم گوگل
• گوگل میت (پیام‌های صوتی، تصویری و چت)

اتصال ldp شما همچنین به شما امکان می‌دهد CSE را برای برنامه‌های دسکتاپ و موبایل زیر تنظیم کنید:

• درایو برای دسکتاپ
• رانندگی در اندروید و iOS
• تقویم در اندروید و iOS
• جیمیل در اندروید و iOS
• ملاقات در اندروید و iOS

همچنین می‌توانید ابزارهای کاربردی زیر را تنظیم کنید:

• رمزگشای CSE

برای استفاده از سرویس کلید رمزگذاری با CSE، به یک ارائه‌دهنده هویت (IdP) نیاز دارید که از استاندارد OpenID Connect (OIDC) پشتیبانی کند. اگر قبلاً از یک IdP OIDC با Google Workspace استفاده نمی‌کنید، می‌توانید IdP خود را برای استفاده با سرویس کلید خود به یکی از دو روش زیر تنظیم کنید:

**گزینه ۱: استفاده از یک IdP شخص ثالث (توصیه می‌شود)**

اگر مدل امنیتی شما نیاز به جداسازی بیشتر داده‌های رمزگذاری شده از گوگل دارد، از یک IdP شخص ثالث OIDC استفاده کنید.

اگر از قبل از یک IdP شخص ثالث برای ورود یکپارچه (SSO) مبتنی بر SAML استفاده می‌کنید: توصیه می‌شود در صورتی که IdP از OIDC پشتیبانی می‌کند، از همان IdP برای CSE که برای دسترسی به سرویس‌های Google Workspace استفاده می‌کنید، استفاده کنید. درباره استفاده از SSO مبتنی بر SAML با Google Workspace بیشتر بدانید .

**گزینه ۲: استفاده از هویت گوگل**

اگر مدل امنیتی شما نیازی به جداسازی بیشتر داده‌های رمزگذاری شده از گوگل ندارد، می‌توانید از هویت پیش‌فرض گوگل به عنوان شناسه کاربری خود استفاده کنید.

اگر از یک IdP شخص ثالث برای CSE استفاده می‌کنید، توصیه می‌شود کوکی‌های شخص ثالث IdP خود را در مرورگرهای کاربران خود مجاز کنید؛ در غیر این صورت، ممکن است کاربران هنگام استفاده از CSE نیاز به ورود بیشتر به IdP شما داشته باشند.

• اگر سازمان شما از Chrome Enterprise استفاده می‌کند: می‌توانید از خط‌مشی CookiesAllowedForUrls استفاده کنید.
• برای مرورگرهای دیگر: برای دستورالعمل‌های مربوط به نحوه‌ی مجاز کردن کوکی‌های شخص ثالث، به محتوای پشتیبانی مرورگر مراجعه کنید.

شما می‌توانید IdP خود را - چه از طریق یک IdP شخص ثالث و چه از طریق هویت گوگل - با استفاده از یک فایل .well-known که در وب‌سایت سازمان خود میزبانی می‌کنید یا کنسول مدیریت (که جایگزین IdP شماست) تنظیم کنید. همانطور که در جدول زیر توضیح داده شده است، برای هر روش ملاحظات مختلفی وجود دارد.

توجه: اگر در حال پیکربندی شناسه مهمان هستید، باید از کنسول مدیریت استفاده کنید.

شما باید یک شناسه کلاینت ایجاد کنید و URLهای تغییر مسیر را برای برنامه‌های وب پشتیبانی‌شده Google Workspace اضافه کنید. برای مشاهده فهرست برنامه‌های پشتیبانی‌شده، به برنامه‌های وب، دسکتاپ و موبایل پشتیبانی‌شده در ابتدای این صفحه مراجعه کنید.

نحوه ایجاد شناسه کلاینت برای برنامه‌های وب بستگی به این دارد که آیا از شناسه شخص ثالث IdP یا Google استفاده می‌کنید.

اگر در حال پیکربندی شناسه کاربری مهمان هستید: باید یک شناسه کلاینت اضافی برای دسترسی به Google Meet ایجاد کنید که برای تأیید دعوت مهمان به جلسه استفاده می‌شود. برای اطلاعات بیشتر، به پیکربندی شناسه کاربری مهمان مراجعه کنید.

**اگر از IdP شخص ثالث برای CSE استفاده می‌کنید**

با استفاده از کنسول مدیریت IdP خود، یک شناسه کلاینت ایجاد کنید. همچنین باید URI های تغییر مسیر زیر را به کنسول مدیریت IdP خود اضافه کنید:

سرویس‌های وب:

• https://client-side-encryption.google.com/callback
• https://client-side-encryption.google.com/oidc/cse/callback
• https://client-side-encryption.google.com/oidc/drive/callback
• https://client-side-encryption.google.com/oidc/gmail/callback
• https://client-side-encryption.google.com/oidc/meet/callback
• https://client-side-encryption.google.com/oidc/calendar/callback
• https://client-side-encryption.google.com/oidc/docs/callback
• https://client-side-encryption.google.com/oidc/sheets/callback
• https://client-side-encryption.google.com/oidc/slides/callback

درایو برای دسکتاپ:

http://localhost

اپلیکیشن موبایل اندروید و iOS:

• https://client-side-encryption.google.com/oidc/gmail/native/callback
• https://client-side-encryption.google.com/oidc/meet/native/callback
• https://client-side-encryption.google.com/oidc/calendar/native/callback
• https://client-side-encryption.google.com/oidc/drive/native/callback
• https://client-side-encryption.google.com/oidc/gmail/meet/native/callback

**اگر از هویت گوگل برای CSE استفاده می‌کنید**

شما باید یک شناسه کلاینت در کنسول Google Cloud ایجاد کنید. آن را در فایل .well-known/cse-configuration یا کنسول Admin اضافه خواهید کرد. همچنین جاوا اسکریپت origins (که به آن cross-origin resource sharing یا CORS نیز گفته می‌شود) را تنظیم کرده و ریدایرکت URI ها را اضافه خواهید کرد.

1. به console.cloud.google.com بروید.
2. یک پروژه جدید Google Cloud ایجاد کنید. دستورالعمل‌ها را دریافت کنید .

   پروژه را هر طور که می‌خواهید تنظیم کنید—فقط برای نگهداری اعتبارنامه‌ها است.

3. در کنسول، به منو بروید APIها و سرویس‌ها مدارک شناسایی .
4. یک شناسه کلاینت OAuth برای برنامه وب جدیدی که با CSE استفاده خواهید کرد، ایجاد کنید. دستورالعمل‌های کامل را دریافت کنید .
5. کدهای جاوا اسکریپت origins را با موارد زیر به‌روزرسانی کنید:
   • https://admin.google.com
   • https://client-side-encryption.google.com
6. URI های تغییر مسیر مجاز را با موارد زیر به روز کنید.

   سرویس‌های وب:

   • https://client-side-encryption.google.com/callback
   • https://client-side-encryption.google.com/oidc/cse/callback
   • https://client-side-encryption.google.com/oidc/drive/callback
   • https://client-side-encryption.google.com/oidc/gmail/callback
   • https://client-side-encryption.google.com/oidc/meet/callback
   • https://client-side-encryption.google.com/oidc/calendar/callback
   • https://client-side-encryption.google.com/oidc/docs/callback
   • https://client-side-encryption.google.com/oidc/sheets/callback
   • https://client-side-encryption.google.com/oidc/slides/callback

   درایو برای دسکتاپ:

   http://localhost

   اپلیکیشن موبایل اندروید و iOS:

   برای برنامه‌های تلفن همراه اندروید و iOS نیازی به پیکربندی اضافی نیست.

یک شناسه کلاینت OAuth ایجاد شده است. این شناسه را ذخیره کنید تا بتوانید آن را به فایل .well-known/cse-configuration یا کنسول مدیریت خود اضافه کنید.

اگر می‌خواهید کاربران شما از CSE با برنامه‌های دسکتاپ و موبایل استفاده کنند، به شناسه‌های کلاینت برای آن برنامه‌ها نیاز دارید. آن‌ها را به فایل .well-known/cse-configuration یا کنسول مدیریت خود اضافه خواهید کرد. همچنین ممکن است لازم باشد شناسه‌های کلاینت را به پیکربندی سرویس کلید خود اضافه کنید - به مستندات سرویس کلید خود مراجعه کنید.

برای هر برنامه تلفن همراه، به یک شناسه کلاینت برای هر پلتفرم (اندروید و iOS) نیاز دارید. برای مشاهده فهرست برنامه‌های پشتیبانی‌شده، به قسمت برنامه‌های وب، دسکتاپ و تلفن همراه پشتیبانی‌شده در ابتدای این صفحه مراجعه کنید.

نحوه دریافت شناسه‌های کلاینت برای برنامه‌های دسکتاپ و موبایل بستگی به این دارد که آیا از یک شناسه IDP شخص ثالث یا هویت گوگل استفاده می‌کنید.

توجه: این شناسه‌های کلاینت باید از نوع اعطای authorization_code برای PKCE ( RFC 7636 ) پشتیبانی کنند.

**اگر از یک IdP شخص ثالث برای CSE استفاده خواهید کرد**

از کنسول مدیریت IdP خود برای ایجاد یک شناسه کلاینت جداگانه برای هر برنامه استفاده کنید.

**اگر از هویت گوگل برای CSE استفاده خواهید کرد**

از شناسه‌های کلاینت زیر استفاده کنید:

• درایو برای دسکتاپ — از شناسه کلاینت 947318989803-k88lapdik9bledfml8rr69ic6d3rdv57.apps.googleusercontent.com استفاده کنید
• رانندگی در اندروید — از شناسه کلاینت 313892590415-6lbccuf47cou4q45vanraqp3fv5jt9do.apps.googleusercontent.com استفاده کنید
• درایو در iOS — از شناسه کلاینت 313892590415-d3h1l7kl4htab916r6jevqdtu8bfmh9m.apps.googleusercontent.com استفاده کنید
• تقویم در اندروید — از شناسه کلاینت 313892590415-q84luo8fon5pn5vl8a6rppo1qvcd3qvn.apps.googleusercontent.com استفاده کنید
• تقویم در iOS — از شناسه کلاینت 313892590415-283b3nilr8561tedgu1n4dcm9hd6g3hr.apps.googleusercontent.com استفاده کنید
• جیمیل در اندروید — از شناسه کلاینت 313892590415-samhd32i4piankgs42o9sit5e9dug452.apps.googleusercontent.com استفاده کنید
• جیمیل در iOS — از شناسه کلاینت 313892590415-ijvjpbnsh0gauuunjgsdn64ngg37k6rc.apps.googleusercontent.com استفاده کنید
• ملاقات در اندروید — از شناسه کلاینت 313892590415-i06v47su4k03ns7ot38akv7s9ari5oa5.apps.googleusercontent.com استفاده کنید
• Meet در iOS — از شناسه کلاینت 313892590415-32ha2bvs0tr1b12s089i33o58hjvqt55.apps.googleusercontent.com استفاده کنید

ما به شما توصیه می‌کنیم که:

1. برای هر ابزار کاربردی که با نقاط پایانی ممتاز (privilegedwrap، privilegedunwrap، privilegedprivatekeydecrypt) سرویس کلید شما تعامل دارد، از یک شناسه کلاینت استفاده کنید. برای مشاهده فهرستی از ابزارهای پشتیبانی‌شده، به بخش «مرور برنامه‌های کاربردی وب، دسکتاپ و موبایل پشتیبانی‌شده و ابزارهای کاربردی» در این صفحه مراجعه کنید.
2. سیاست‌های دسترسی سرویس کلید خود را برای نقاط پایانی privilegedunwrap و privilegedprivatekeydecrypt پیکربندی کنید تا شناسه کلاینت رمزگشای CSE مجاز باشد.

پیکربندی IdP شما باید در این URI در دامنه شما قرار گیرد:

https: //cse.subdomain.domain.tld /.well-known/cse-configuration

که در آن subdomain.domain.tld باید با دامنه موجود در آدرس ایمیل شما مطابقت داشته باشد. برای مثال، اگر دامنه موجود در آدرس ایمیل شما solarmora.com است، باید فایل .well-known خود را در آدرس زیر قرار دهید:

https://cse.solarmora.com/.well-known/cse-configuration

نکته: پیشوند https://cse. الزامی است زیرا آدرس .well-known در IETF ( RFC 8615 ) ثبت نشده است.

محتویات فایل .well-known شما، در آدرس well-known/cse-configuration، باید با JSON کدگذاری شده باشد ( RFC 8259 ) و شامل این فیلدها باشد:

**اگر از یک IdP شخص ثالث استفاده می‌کنید، فایل .well-known شما باید به این شکل باشد:**

**اگر از هویت گوگل استفاده می‌کنید، فایل .well-known شما باید به این شکل باشد:**

اگر از هویت گوگل برای IdP خود استفاده می‌کنید: هنگام ایجاد شناسه کلاینت خود، CORS را در کنسول Google Cloud تنظیم می‌کنید. برای جزئیات بیشتر، به بخش «ایجاد شناسه کلاینت برای برنامه‌های وب» که قبلاً در این صفحه آمده است، مراجعه کنید.

اگر از یک IdP شخص ثالث استفاده می‌کنید: .well-known/openid-configuration و .well-known/cse-configuration شما باید URL های مبدا را برای فراخوانی‌های اشتراک‌گذاری منابع بین مبدا (CORS) مجاز کنند. در کنسول مدیریت IdP خود، پیکربندی‌های خود را به شرح زیر تنظیم کنید:

‎.well-known/openid-configuration (URI کشف)

• روش‌ها: دریافت
• مبداهای مجاز:
  • https://admin.google.com
  • https://client-side-encryption.google.com

.well-known/cse-configuration

• روش‌ها: دریافت
• مبداهای مجاز:
  • https://admin.google.com
  • https://client-side-encryption.google.com

برای اتصال به IdP خود با استفاده از کنسول مدیریت، به اطلاعات زیر در مورد IdP خود نیاز دارید:

اگر از هویت گوگل استفاده می‌کنید: هنگام ایجاد شناسه کلاینت خود، اشتراک‌گذاری منابع بین مبدا (CORS) را در کنسول Google Cloud تنظیم می‌کنید. برای جزئیات بیشتر، به بخش «ایجاد شناسه کلاینت برای برنامه‌های وب» که قبلاً در این صفحه آمده است، مراجعه کنید.

اگر از IdP شخص ثالث استفاده می‌کنید: در کنسول مدیریت IdP خود، URI مربوط به کشف خود را پیکربندی کنید تا URLهای مبدا برای فراخوانی‌های اشتراک‌گذاری منابع بین مبدا (CORS) مجاز باشند، به شرح زیر:

• روش: دریافت
• مبداهای مجاز:
  • https://admin.google.com
  • https://client-side-encryption.google.com