استفاده از دسترسی مبتنی بر توکن برای برقراری تماس API Ethereum با گره های اتریوم در آمازون blockchain

همچنین می توانید از نشانه های Accessor برای برقراری تماس های API Ethereum به یک گره Ethereum به عنوان یک جایگزین مناسب برای امضای امضا نسخه 4 (SIGV4) استفاده کنید. شما باید از یکی از نشانه های دسترسی که به عنوان یک پارامتر پرس و جو با تماس ایجاد می کنید ، یک billing_token را تهیه کنید.

مهم

• اگر امنیت و حسابرسی را بیش از راحتی در اولویت قرار می دهید ، به جای آن از فرآیند امضای SIGV4 استفاده کنید.
• با استفاده از امضای نسخه 4 (SIGV4) و دسترسی مبتنی بر توکن می توانید به API های Ethereum دسترسی پیدا کنید. با این حال ، اگر تصمیم دارید از هر دو پروتکل استفاده کنید ، هرگونه مزایای امنیتی که با استفاده از SIGV4 ارائه می شود ، نفی می شوند.
• هرگز نشانه های دسترسی در برنامه های کاربر را جاسازی نکنید.

در کنسول ، صفحه Accessors Token لیستی از تمام نشانه های دسترسی را نشان می دهد که می توانید از آنها برای برقراری تماس های API Ethereum به گره های موجود در حساب AWS خود از کد روی مشتری استفاده کنید. نقاط پایانی جداگانه برای اتصالات HTTP و اتصالات WebSocket وجود دارد.

برای کسب اطلاعات بیشتر در مورد چگونگی برقراری تماس های API Ethereum با استفاده از دسترسی مبتنی بر توکن با نشانه های Accessor ، ببینید:

• با استفاده از دسترسی مبتنی بر توکن برای تماس با JSON-RPC API با یک گره اتریوم.
• استفاده از دسترسی مبتنی بر توکن برای ایجاد تماس های API اجماع به یک گره اتریوم.

شما می توانید نشانه های Accessor را با استفاده از Ethereum در کنسول blockchain مدیریت شده ایجاد و مدیریت کنید. همچنین می توانید با استفاده از عملیات API زیر ، نشانه های Accessor را ایجاد و مدیریت کنید: CreateAcsessor ، GetAccessor ، ListAccessors و DeleteAcessor. یک شیء Accessor Token یک ظروف است که اطلاعاتی را برای دسترسی به توکن به گره های اتریوم در حساب AWS شما دارد. یک نشانه صورتحساب نیز هنگام ایجاد یک شیء Accessor ایجاد می شود. این نشانه صورتحساب برای ردیابی نشانه دسترسی شما برای صدور صورتحساب درخواست های API Ethereum که به گره های اتریوم در حساب AWS شما انجام شده است ، استفاده می شود.

کلیه اقدامات API مربوط به ایجاد و مدیریت نشانه های Accessor از طریق AWS CLI و SDK ها در دسترس است.

ایجاد یک نشانه دسترسی برای دسترسی مبتنی بر توکن

شما می توانید یک نشانه دسترسی ایجاد کنید و از آن برای برقراری تماس های API Ethereum با هر گره اتریوم در حساب AWS خود استفاده کنید.

1. کنسول blockchain مدیریت شده را در https://console. aws. amazon. com/managedblockchain/ باز کنید.
2. دسترسی های توکن را انتخاب کنید.
3. برای ایجاد یک نشانه دسترسی جدید ، جدید را انتخاب کنید.

AWS ManageredBlockChain Creat-Accessor-Accessor-Type Billing_Token

دستور قبلی همانطور که در مثال زیر نشان داده شده است ، AccessOrid را به همراه BillingToken برمی گرداند.

 "AccessorId": "ac-NGQ6QNKXLNEBXD3UI6XFDIL3VA", "BillingToken": "jZlP8OUI-PcQSKINyX9euJJDC5-IcW9e-nm1NyKH3n">

عنصر اصلی در پاسخ BillingToken است. شما می توانید از این ویژگی برای برقراری تماس های API Ethereum به گره های اتریوم خود استفاده کنید.

توجه داشته باشید

شما می توانید از BillingToken برای برقراری تماس API Ethereum به تمام گره های متعلق به حساب AWS که توکن Accessor را ایجاد کرده است استفاده کنید.

مشاهده جزئیات توکن دسترسی

شما می توانید ویژگی های مربوط به هر نشانه دسترسی که حساب AWS شما را در اختیار دارد ، مشاهده کنید. به عنوان مثال ، می توانید شناسه Accessor یا نام منابع آمازون (ARN) Accessor را مشاهده کنید. همچنین می توانید وضعیت ، نوع ، تاریخ ایجاد و BillingToken را مشاهده کنید.

1. کنسول blockchain مدیریت شده را در https://console. aws. amazon. com/managedblockchain/ باز کنید.
2. در صفحه ناوبری ، دسترسی های توکن را انتخاب کنید.
3. شناسه Accessor Token را از لیست انتخاب کنید.

دستور زیر را اجرا کنید تا جزئیات یک نشانه دسترسی را مشاهده کنید. مقادیر-ACCESSOR-ID را با شناسه دسترسی خود جایگزین کنید.

AWS ManageredBlockChain Get-Accessor-Accessor-IDac-ngq6qnkxlnebxd3ui6xfdil3va

همانطور که در مثال زیر نشان داده شده است ، BillingToken و سایر خصوصیات کلیدی بازگردانده می شوند.

 "Accessor": "Id": "ac-NGQ6QNKXLNEBXD3UI6XFDIL3VA", "Type": "BILLING_TOKEN", "BillingToken": "jZlP8OUI-PcQSKINyX9euJJDC5-IcW9e-nm1NyKH3n", "Status": "AVAILABLE", "CreationDate": "2022-01-04T23:09:47.750Z", "A": "a:aws:managedblockchain:us-east-1:251534485660:accessors/ac-NGQ6QNKXLNEBXD3UI6XFDIL3VA">> 

حذف یک نشانه دسترسی

هنگامی که یک نشانه Accessor را حذف می کنید ، نشانه از موجود به وضعیت در انتظار_دلتون تغییر می کند. شما نمی توانید از یک نشانه Accessor با وضعیت در حال انتظار_دلتون برای درخواست های WebSocket و درخواست های HTTP استفاده کنید.

توجه داشته باشید

اتصالات WebSocket که در حالی که نشانه دسترسی در وضعیت موجود بود ، آغاز شده است ممکن است تا 2 ساعت پس از انقضا باز باقی بماند. یک نشانه دسترسی با وضعیت در انتظار_دلتون در نهایت از طریق تماس های GetAccessor در دسترس نیست. طی 48 ساعت ، از نتایج ListAccessor نیز ناپدید می شود.

1. کنسول blockchain مدیریت شده را در https://console. aws. amazon. com/managedblockchain/ باز کنید.
2. در صفحه ناوبری ، دسترسی های توکن را انتخاب کنید.
3. نشانه Accessor را که می خواهید از لیست انتخاب کنید.
4. حذف را انتخاب کنید.
5. انتخاب خود را تأیید کنید.

مثال زیر نحوه حذف یک نشانه را نشان می دهد. برای حذف یک نشانه از دستور Delete-Accessor استفاده کنید. مقدار-ACCESSOR-ID را با شناسه دسترسی خود تنظیم کنید.

حذف یک نشانه دسترسی با استفاده از AWS CLI

AWS ManageredBlockChain حذف- ACCESSOR-ACCESSOR-IDac-ngq6qnkxlnebxd3ui6xfdil3va

اگر این دستور با موفقیت اجرا شود ، هیچ پیامی بازگردانده نمی شود.