اشتراک‌گذاری بی‌وقفه اعتبارنامه را در برنامه‌ها و وب‌سایت‌های Android تنظیم کنید

با فعال کردن اشتراک گذاری اعتبار بین پلتفرمی بدون درز در برنامه ها و وب سایت های خود، راحتی کاربر را به حداکثر برسانید. هنگامی که چندین وب‌سایت و برنامه اندرویدی یک پشتیبان مدیریت حساب را به اشتراک می‌گذارند، این ویژگی به کاربران امکان می‌دهد یک بار اعتبارنامه‌ها را ذخیره کنند و به‌طور خودکار در هر وب‌سایت یا برنامه Android پیوندی پیشنهاد شوند.

دو روش پشتیبانی شده برای راه اندازی اشتراک گذاری اعتبار وجود دارد:

  • کنسول Play : هنگام تنظیم اشتراک‌گذاری اعتبار با برنامه‌های Android، برای اکثر برنامه‌نویسان توصیه می‌شود. این روش به شما امکان می‌دهد بدون نیاز به انتشار نسخه جدیدی از برنامه، اشتراک‌گذاری اعتبار را پیکربندی کنید. توجه داشته باشید که حتی هنگام استفاده از کنسول Play، همچنان باید یک فایل assetlinks.json معتبر در وب سایت خود منتشر کنید.
  • پیوندهای دارایی دیجیتال (DAL) : مناسب برای موارد استفاده پیشرفته، مانند پشتیبانی از چندین برنامه یا دامنه با پیکربندی های پیچیده تر.

بهترین شیوه ها

برای تجربه و امنیت بهینه کاربر، اشتراک‌گذاری یکپارچه اعتبارنامه را در این نقاط تماس اجرا کنید:

  • فرم ورود به سیستم : پر کردن خودکار اعتبارنامه را فعال کنید.
  • فرم ثبت نام : اعتبارنامه های جدید را به صورت ایمن برای استفاده در پلتفرم ها ذخیره کنید.
  • فرم تغییر رمز عبور : به روز رسانی رمز عبور را در همه سیستم عامل ها همگام سازی کنید.
  • فرم بازنشانی رمز عبور : به بازنشانی رمز عبور تکی برای به‌روزرسانی همه پلتفرم‌ها اجازه دهید.
  • دامنه‌های مشاهده وب : اشتراک‌گذاری اعتبار را به دامنه‌های مشاهده وب در برنامه خود که مدیریت حساب را مدیریت می‌کنند (ورود به میزبان، ثبت‌نام، تغییر رمز عبور یا فرم‌های بازنشانی رمز عبور) گسترش دهید.
  • برنامه های اندروید

این رویکرد یک سیستم مدیریت اعتبار یکپارچه ایجاد می کند و راحتی و امنیت کاربر را افزایش می دهد.

هنگام طراحی وب سایت های مدیریت حساب خود، به شما پیشنهاد می کنیم بهترین روش ها را برای سایت های مدیریت حساب دنبال کنید:

هنگام طراحی برنامه های Android خود، توصیه می کنیم برنامه خود را با Android Credential Manager ادغام کنید .

اشتراک گذاری اعتبار را با استفاده از کنسول Play تنظیم کنید

اکنون می‌توانید بدون انتشار نسخه جدیدی از برنامه اندروید خود، اشتراک‌گذاری بی‌وقفه اعتبار را مستقیماً از کنسول Play فعال کنید. این روش با مدیریت تنظیمات اشتراک‌گذاری اعتبار شما از طریق رابط Play Console، فرآیند را ساده می‌کند.

پیش نیازها

قبل از راه‌اندازی اشتراک‌گذاری اعتبار با استفاده از کنسول Play، مطمئن شوید:

  • مجوزهای لازم کنسول Play برای دسترسی به پیوندهای عمیق و بخش‌های پیکربندی برنامه . اگر مالک حساب نیستید، از سرپرست کنسول Play خود بخواهید به شما دسترسی مناسب را بدهد.
  • امکان انتشار فایل /.well-known/assetlinks.json در هر دامنه مربوطه، به دنبال نحو پیوند دارایی دیجیتال (DALs) .

اشتراک گذاری اعتبار برای یک دامنه جدید را فعال کنید

برای راه‌اندازی اشتراک‌گذاری بی‌وقفه اعتبارنامه در کنسول Play برای یک دامنه جدید، این مراحل را دنبال کنید:

  1. کنسول Play را باز کنید و به صفحه پیوندهای عمیق ( رشد کاربران > پیوندهای عمیق ) بروید.
  2. در برگه پیکربندی برنامه ، روی افزودن دامنه کلیک کنید.
  3. دامنه وب سایت خود را وارد کنید.
  4. کلید فعال کردن اشتراک‌گذاری اعتبارنامه را روشن کنید.
  5. فایل JSON تولید شده را کپی کرده و در مکان مشخص شده منتشر کنید ( https://YOUR_DOMAIN/.well-known/assetlinks.json طبق پروتکل )، یا اطلاعات مربوطه را به فایل assetlinks.json موجود اضافه کنید.
  6. روی Create website Association کلیک کنید.

در صورت موفقیت، به صفحه پیوندهای عمیق باز خواهید گشت.

اشتراک گذاری اعتبار برای یک دامنه موجود را فعال کنید

برای راه‌اندازی اشتراک‌گذاری اعتبار یکپارچه در Play Console برای یک دامنه موجود، این مراحل را دنبال کنید:

  1. تب پیکربندی برنامه را انتخاب کنید.
  2. در بخش دامنه‌ها ، در قسمت پیکربندی برنامه ، روی روشن کردن در ستون اشتراک‌گذاری اعتبار کلیک کنید.
  3. فایل JSON تولید شده را کپی کرده و در محل مشخص شده منتشر کنید (یا اطلاعات مربوطه را به فایل assetlinks.json موجود اضافه کنید).
  4. روی روشن کردن اشتراک‌گذاری اعتبار کلیک کنید.

در صورت موفقیت، به صفحه پیوندهای عمیق باز خواهید گشت.

راه‌اندازی اشتراک‌گذاری اعتبار فقط با استفاده از پیوندهای دارایی دیجیتال (DAL)

برای تنظیمات پیچیده که شامل چندین برنامه یا وب‌سایت است، از پیوندهای دارایی دیجیتال (DAL) برای پیکربندی اشتراک‌گذاری اعتبار به صورت دستی استفاده کنید.

پیش نیازها

قبل از راه‌اندازی اشتراک‌گذاری یکپارچه اعتبارنامه، مطمئن شوید که برای هر پلتفرم موارد زیر را دارید:

برای هر برنامه اندروید:

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

  • امکان انتشار فایل /.well-known/assetlinks.json در هر دامنه مربوطه، به دنبال نحو پیوند دارایی دیجیتال (DALs) .
  • همه دامنه های مدیریت حساب (ورود به سیستم، ثبت نام، تغییر رمز عبور یا فرم های بازنشانی رمز عبور) باید از طریق HTTPS قابل دسترسی باشند.

اشتراک‌گذاری یکپارچه اعتبارنامه را در برنامه‌ها و وب‌سایت‌های Android فعال کنید

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

برای اعلام رابطه اشتراک اعتبار:

  1. یک فایل assetlinks.json با عباراتی که به وب‌سایت و برنامه Android پیوند می‌یابند، به دنبال نحو فهرست دستورات DAL ایجاد کنید:

    [
  {
    "relation":[
      "delegate_permission/common.get_login_creds"
    ],
    "target":{
      "namespace":"web",
      "site":URL
    }
  },
  {
    "relation":[
      "delegate_permission/common.get_login_creds"
    ],
    "target":{
      "namespace":"android_app",
      "package_name":"APP_ID",
      "sha256_cert_fingerprints":[
        "SHA_HEX_VALUE"
      ]
    }
  }
]

    جایی که URL آدرس سایت شما است، APP_ID شناسه برنامه Android شما است و SHA_HEX_VALUE اثر انگشت SHA256 گواهی امضای برنامه Android شما است.

    فیلد relation رابطه ای را که اعلام می شود توصیف می کند. برای اعلام اینکه برنامه‌ها و سایت‌ها اعتبارنامه ورود به سیستم را به اشتراک می‌گذارند، روابط را به‌عنوان delegate_permission/common.get_login_creds مشخص کنید. درباره رشته های رابطه در DAL بیشتر بیاموزید.

    فیلد target یک شی است که دارایی را مشخص می کند که اظهارنامه برای آن اعمال می شود.

    فیلدهای زیر یک وب سایت را مشخص می کند:

    namespace

    web

    site

    آدرس وب سایت، با فرمت https://domain[:optional_port ]; به عنوان مثال، https://www.example.com.

    domain باید کاملاً واجد شرایط باشد، و optional_port باید هنگام استفاده از پورت 443 برای HTTPS حذف شود.

    هدف site فقط می تواند یک دامنه ریشه باشد: شما نمی توانید یک انجمن برنامه را به یک زیر شاخه خاص محدود کنید. مسیری را در URL وارد نکنید، مانند یک اسلش انتهایی.

    دامنه‌های فرعی مطابقت ندارند: یعنی اگر domain به عنوان www.example.com مشخص کنید، دامنه www.counter.example.com با برنامه شما مرتبط نیست.

    فیلدهای زیر یک برنامه اندروید را مشخص می کند:

    فضای نام

    android_app

    بسته_نام

    نام بسته اعلام شده در مانیفست برنامه. برای مثال com.example.android

    sha256_cert_prints

    اثر انگشت SHA256 گواهی امضای برنامه شما.

  2. فایل JSON پیوندهای دارایی دیجیتال را در مکان زیر در دامنه‌های ورود میزبانی کنید: https:// DOMAIN [: OPTIONAL_PORT ]/.well-known/assetlinks.json ، جایی که DOMAIN کاملاً واجد شرایط است، و هنگام استفاده از پورت 443 برای HTTPS OPTIONAL_PORT باید حذف شود.

  3. با جاسازی عبارتی در فایل res/values/strings.xml برنامه Android خود که به لیست دستوراتی که در مرحله 1 ایجاد کرده‌اید پیوند دارد، ارتباط را در برنامه Android اعلام کنید. یک شی اضافه کنید که فایل‌های assetlinks.json را برای بارگیری مشخص می‌کند. به عنوان مثال:

      <string name="asset_statements" translatable="false">
[{
  \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
}]
</string>

    DOMAIN و OPTIONAL_PORT جایگزین کنید (در هنگام استفاده از پورت 443 برای HTTPS باید حذف شود) - برای مثال https://www.example.com . از هر آپستروف و علامت نقل قولی که در رشته استفاده می کنید فرار کنید.

    همانطور که در مستندات DAL نشان داده شده است می توانید یک قطعه JSON را در فایل strings.xml خود اضافه کنید، اما استفاده از عبارت include به شما امکان می دهد بدون انتشار نسخه جدیدی از برنامه خود، دستورات را تغییر دهید.

  4. با افزودن خط زیر به فایل AndroidManifest.xml برنامه خود در زیر <application> ، به عبارت موجود در مانیفست ارجاع دهید:

    <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>

  5. نسخه جدید برنامه اندروید خود را در کنسول برنامه‌نویس Google Play منتشر کنید

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

توجه داشته باشید که این تنها راه معتبر برای راه‌اندازی DAL برای اشتراک‌گذاری اعتبار نیست، اما این رویکرد فرآیند آتی افزودن موجودیت‌های جدید به شبکه اشتراک‌گذاری اعتبار یکپارچه شما را ساده می‌کند، قابلیت استفاده مجدد کد را ارتقا می‌دهد و احتمال خطا در طول به‌روزرسانی را کاهش می‌دهد.

،

با فعال کردن اشتراک گذاری اعتبار بین پلتفرمی بدون درز در برنامه ها و وب سایت های خود، راحتی کاربر را به حداکثر برسانید. هنگامی که چندین وب‌سایت و برنامه اندرویدی یک پشتیبان مدیریت حساب را به اشتراک می‌گذارند، این ویژگی به کاربران امکان می‌دهد یک بار اعتبارنامه‌ها را ذخیره کنند و به‌طور خودکار در هر وب‌سایت یا برنامه Android پیوندی پیشنهاد شوند.

دو روش پشتیبانی شده برای راه اندازی اشتراک گذاری اعتبار وجود دارد:

  • کنسول Play : هنگام تنظیم اشتراک‌گذاری اعتبار با برنامه‌های Android، برای اکثر برنامه‌نویسان توصیه می‌شود. این روش به شما امکان می‌دهد بدون نیاز به انتشار نسخه جدیدی از برنامه، اشتراک‌گذاری اعتبار را پیکربندی کنید. توجه داشته باشید که حتی هنگام استفاده از کنسول Play، همچنان باید یک فایل assetlinks.json معتبر در وب سایت خود منتشر کنید.
  • پیوندهای دارایی دیجیتال (DAL) : مناسب برای موارد استفاده پیشرفته، مانند پشتیبانی از چندین برنامه یا دامنه با پیکربندی های پیچیده تر.

بهترین شیوه ها

برای تجربه و امنیت بهینه کاربر، اشتراک‌گذاری یکپارچه اعتبارنامه را در این نقاط تماس اجرا کنید:

  • فرم ورود به سیستم : پر کردن خودکار اعتبارنامه را فعال کنید.
  • فرم ثبت نام : اعتبارنامه های جدید را به صورت ایمن برای استفاده در پلتفرم ها ذخیره کنید.
  • فرم تغییر رمز عبور : به روز رسانی رمز عبور را در همه سیستم عامل ها همگام سازی کنید.
  • فرم بازنشانی رمز عبور : به بازنشانی رمز عبور تکی برای به‌روزرسانی همه پلتفرم‌ها اجازه دهید.
  • دامنه‌های مشاهده وب : اشتراک‌گذاری اعتبار را به دامنه‌های مشاهده وب در برنامه خود که مدیریت حساب را مدیریت می‌کنند (ورود به میزبان، ثبت‌نام، تغییر رمز عبور یا فرم‌های بازنشانی رمز عبور) گسترش دهید.
  • برنامه های اندروید

این رویکرد یک سیستم مدیریت اعتبار یکپارچه ایجاد می کند و راحتی و امنیت کاربر را افزایش می دهد.

هنگام طراحی وب سایت های مدیریت حساب خود، به شما پیشنهاد می کنیم بهترین روش ها را برای سایت های مدیریت حساب دنبال کنید:

هنگام طراحی برنامه های Android خود، توصیه می کنیم برنامه خود را با Android Credential Manager ادغام کنید .

راه‌اندازی اشتراک‌گذاری اعتبار با استفاده از کنسول Play

اکنون می‌توانید بدون انتشار نسخه جدیدی از برنامه اندروید خود، اشتراک‌گذاری بی‌وقفه اعتبار را مستقیماً از کنسول Play فعال کنید. این روش با مدیریت تنظیمات اشتراک‌گذاری اعتبار شما از طریق رابط Play Console، فرآیند را ساده می‌کند.

پیش نیازها

قبل از راه‌اندازی اشتراک‌گذاری اعتبار با استفاده از کنسول Play، مطمئن شوید:

  • مجوزهای لازم کنسول Play برای دسترسی به پیوندهای عمیق و بخش‌های پیکربندی برنامه . اگر مالک حساب نیستید، از سرپرست کنسول Play خود بخواهید به شما دسترسی مناسب را بدهد.
  • امکان انتشار فایل /.well-known/assetlinks.json در هر دامنه مربوطه، به دنبال نحو پیوند دارایی دیجیتال (DALs) .

اشتراک گذاری اعتبار برای یک دامنه جدید را فعال کنید

برای راه‌اندازی اشتراک‌گذاری بی‌وقفه اعتبارنامه در کنسول Play برای یک دامنه جدید، این مراحل را دنبال کنید:

  1. کنسول Play را باز کنید و به صفحه پیوندهای عمیق ( رشد کاربران > پیوندهای عمیق ) بروید.
  2. در برگه پیکربندی برنامه ، روی افزودن دامنه کلیک کنید.
  3. دامنه وب سایت خود را وارد کنید.
  4. کلید فعال کردن اشتراک‌گذاری اعتبارنامه را روشن کنید.
  5. فایل JSON تولید شده را کپی کرده و در مکان مشخص شده منتشر کنید ( https://YOUR_DOMAIN/.well-known/assetlinks.json طبق پروتکل )، یا اطلاعات مربوطه را به فایل assetlinks.json موجود اضافه کنید.
  6. روی Create website Association کلیک کنید.

در صورت موفقیت، به صفحه پیوندهای عمیق باز خواهید گشت.

اشتراک گذاری اعتبار برای یک دامنه موجود را فعال کنید

برای راه‌اندازی اشتراک‌گذاری یکپارچه اطلاعات کاربری در کنسول Play برای دامنه موجود، این مراحل را دنبال کنید:

  1. تب پیکربندی برنامه را انتخاب کنید.
  2. در بخش دامنه‌ها ، در قسمت پیکربندی برنامه ، روی روشن کردن در ستون اشتراک‌گذاری اعتبار کلیک کنید.
  3. فایل JSON تولید شده را کپی کرده و در محل مشخص شده منتشر کنید (یا اطلاعات مربوطه را به فایل assetlinks.json موجود اضافه کنید).
  4. روی روشن کردن اشتراک‌گذاری اعتبار کلیک کنید.

در صورت موفقیت، به صفحه پیوندهای عمیق باز خواهید گشت.

راه‌اندازی اشتراک‌گذاری اعتبار فقط با استفاده از پیوندهای دارایی دیجیتال (DAL)

برای تنظیمات پیچیده که شامل چندین برنامه یا وب‌سایت است، از پیوندهای دارایی دیجیتال (DAL) برای پیکربندی اشتراک‌گذاری اعتبار به صورت دستی استفاده کنید.

پیش نیازها

قبل از راه‌اندازی اشتراک‌گذاری یکپارچه اعتبارنامه، مطمئن شوید که برای هر پلتفرم موارد زیر را دارید:

برای هر برنامه اندروید:

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

  • امکان انتشار فایل /.well-known/assetlinks.json در هر دامنه مربوطه، به دنبال نحو پیوند دارایی دیجیتال (DALs) .
  • همه دامنه های مدیریت حساب (ورود به سیستم، ثبت نام، تغییر رمز عبور یا فرم های بازنشانی رمز عبور) باید از طریق HTTPS قابل دسترسی باشند.

اشتراک‌گذاری یکپارچه اعتبارنامه را در برنامه‌ها و وب‌سایت‌های Android فعال کنید

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

برای اعلام رابطه اشتراک اعتبار:

  1. یک فایل assetlinks.json با عباراتی که به وب‌سایت و برنامه Android پیوند می‌یابند، به دنبال نحو فهرست دستورات DAL ایجاد کنید:

    [
  {
    "relation":[
      "delegate_permission/common.get_login_creds"
    ],
    "target":{
      "namespace":"web",
      "site":URL
    }
  },
  {
    "relation":[
      "delegate_permission/common.get_login_creds"
    ],
    "target":{
      "namespace":"android_app",
      "package_name":"APP_ID",
      "sha256_cert_fingerprints":[
        "SHA_HEX_VALUE"
      ]
    }
  }
]

    جایی که URL آدرس سایت شما است، APP_ID شناسه برنامه Android شما است و SHA_HEX_VALUE اثر انگشت SHA256 گواهی امضای برنامه Android شما است.

    فیلد relation رابطه ای را که اعلام می شود توصیف می کند. برای اعلام اینکه برنامه‌ها و سایت‌ها اعتبارنامه ورود به سیستم را به اشتراک می‌گذارند، روابط را به‌عنوان delegate_permission/common.get_login_creds مشخص کنید. درباره رشته های رابطه در DAL بیشتر بیاموزید.

    فیلد target یک شی است که دارایی را مشخص می کند که اظهارنامه برای آن اعمال می شود.

    فیلدهای زیر یک وب سایت را مشخص می کند:

    namespace

    web

    site

    آدرس وب سایت، با فرمت https://domain[:optional_port ]; به عنوان مثال، https://www.example.com.

    domain باید کاملاً واجد شرایط باشد، و optional_port باید هنگام استفاده از پورت 443 برای HTTPS حذف شود.

    هدف site فقط می تواند یک دامنه ریشه باشد: شما نمی توانید یک انجمن برنامه را به یک زیر شاخه خاص محدود کنید. مسیری را در URL وارد نکنید، مانند یک اسلش انتهایی.

    دامنه‌های فرعی مطابقت ندارند: یعنی اگر domain به عنوان www.example.com مشخص کنید، دامنه www.counter.example.com با برنامه شما مرتبط نیست.

    فیلدهای زیر یک برنامه اندروید را مشخص می کند:

    فضای نام

    android_app

    بسته_نام

    نام بسته اعلام شده در مانیفست برنامه. برای مثال com.example.android

    sha256_cert_prints

    اثر انگشت SHA256 گواهی امضای برنامه شما.

  2. فایل JSON پیوندهای دارایی دیجیتال را در مکان زیر در دامنه‌های ورود میزبانی کنید: https:// DOMAIN [: OPTIONAL_PORT ]/.well-known/assetlinks.json ، جایی که DOMAIN کاملاً واجد شرایط است، و هنگام استفاده از پورت 443 برای HTTPS OPTIONAL_PORT باید حذف شود.

  3. با جاسازی عبارتی در فایل res/values/strings.xml برنامه Android خود که به لیست دستوراتی که در مرحله 1 ایجاد کرده‌اید پیوند دارد، ارتباط را در برنامه Android اعلام کنید. یک شی اضافه کنید که فایل‌های assetlinks.json را برای بارگیری مشخص می‌کند. به عنوان مثال:

      <string name="asset_statements" translatable="false">
[{
  \"include\": \"https://DOMAIN[:OPTIONAL_PORT]/.well-known/assetlinks.json\"
}]
</string>

    DOMAIN و OPTIONAL_PORT جایگزین کنید (در هنگام استفاده از پورت 443 برای HTTPS باید حذف شود) - برای مثال https://www.example.com . از هر آپستروف و علامت نقل قولی که در رشته استفاده می کنید فرار کنید.

    همانطور که در مستندات DAL نشان داده شده است می توانید یک قطعه JSON را در فایل strings.xml خود اضافه کنید، اما استفاده از عبارت include به شما امکان می دهد بدون انتشار نسخه جدیدی از برنامه خود، دستورات را تغییر دهید.

  4. با افزودن خط زیر به فایل AndroidManifest.xml برنامه خود در زیر <application> ، به عبارت موجود در مانیفست ارجاع دهید:

    <meta-data android:name="asset_statements" android:resource="@string/asset_statements"/>

  5. نسخه جدید برنامه اندروید خود را در کنسول برنامه‌نویس Google Play منتشر کنید

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

توجه داشته باشید که این تنها راه معتبر برای راه‌اندازی DAL برای اشتراک‌گذاری اعتبار نیست، اما این رویکرد فرآیند آتی افزودن موجودیت‌های جدید به شبکه اشتراک‌گذاری اعتبار یکپارچه شما را ساده می‌کند، قابلیت استفاده مجدد کد را ارتقا می‌دهد و احتمال خطا در طول به‌روزرسانی را کاهش می‌دهد.