توکن زیپین چیست؟

مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST API

Site24x7 مجموعه ای جامع از API های REST مستند را برای نیازهای نظارت و گزارش شما ارائه می دهد. برای ارائه دسترسی ایمن تر به منابع شما، ما در حال انتقال به پروتکل OAuth 2. 0 از توکن های مجاز برای مجوز APIها هستیم.

چرا به OAuth 2. 0 حرکت کنیم؟

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

شروع به کار با OAuth 2. 0:

توکن OAuth را می توان در 3 مرحله ایجاد کرد:

• ثبت درخواست مشتری شما
• ایجاد گرانت توکن
• تولید توکن های دسترسی و تازه سازی با استفاده از Grant Token

هنگام برقراری تماس API، نشانه OAuth در هدر مجوز به عنوان Zoho-oauthtoken ارسال می شود، شبیه به authtoken (Zoho-authtoken).

منسوخ شدن توکن ها:

ایجاد اتوکن های جدید تا 31 آگوست 2019 منسوخ خواهد شد و موارد موجود تا 30 نوامبر 2019 منسوخ خواهند شد. لطفاً کد/اسکریپت موجود خود را به روز کنید و در مدت زمان ذکر شده به OAuth 2. 0 مهاجرت کنید.

پاسخ: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

یک یادآوری ملایم برای مهاجرت به OAuth 2. 0. شما نمی توانید اتوکن های جدید ایجاد کنید (منسوخ شده در 31 آگوست 2019) و موارد موجود تا 30 نوامبر 2019 منسوخ خواهند شد.

Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

لطفاً پیاده سازی های نمونه به روز شده (اسکریپت های پایتون و پاورشل) را با استفاده از توکن های OAuth 2. 0 پیوست کنید. این مقاله را بخوانید تا درباره پیکربندی مجوز Postman برای Site24x7 API بیشتر بدانید.

برای هر گونه سوال، لطفا در تاپیک زیر نظر دهید.

Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

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

اسکریپت در وضعیت فعلی خود فقط می تواند رمز دسترسی را تولید کند و فقط یک بار آن را به روز کند.

فقط اضافه کردن یک خط به متد refreshAccessToken() آن را برای من برطرف کرد.

Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

بابت اشاره به این موضوع تشکر می کنیم. لطفاً اسکریپت به روز شده پایتون را پیوست شده بیابید. فایل پایتون را در کامنت قبلی خود دوباره آپلود کرده ام.

امیدوارم این کمک کند. برای سوالات بیشتر، در صورت وجود، به ما اطلاع دهید.

Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

سلام، شما نمی خواهید یک مثال در جاوا نوشته شده باشد؟با تشکر.

Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ممنون که این را مطرح کردیدما روی این موضوع کار می کنیم. پس از آماده شدن فایل، یک به روز رسانی در اینجا ارسال می شود.

Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ممنون و متاسفم که باید می گفتم جاوا اسکریپت نه جاوا. قدر آن را بدانیم

Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ما نمونه دیگری از پیاده سازی را در Golang منتشر کرده ایم. لطفا اسکریپت پیوست شده را در این پست بیابید.

توجه: go1. 12 حداقل نسخه مورد نیاز برای اجرای این برنامه است.

برای هر گونه سوال، لطفا در تاپیک زیر نظر دهید.

Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ما با اسکریپت Powershell که شما ارائه کرده اید آزمایش کرده ایم. ما چندین بار توابع Get-AccessToken و Sample-GetRequest را فراخوانی کردیم.

اما مشکلی که ما با آن مواجه هستیم این است که به طور متناوب یک خطا دریافت می کنیم که می گوید: Invoke-WebRequest: اتصال زیربنایی بسته شد: یک خطای غیرمنتظره در ارسال رخ داد.. اخطار: access_token وجود ندارد

ما هر 10 دقیقه یک بار با Sample-GetRequest تماس می گیریم و در نهایت پس از چند بار تلاش مجدد با موفقیت اجرا می شود.

هر گونه راهنمایی پذیرفته می شود

Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

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

Re: Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

لطفا اجرای نمونه به روز شده در جاوا اسکریپت را پیوست شده بیابید.

توجه: مطمئن شوید که Node. js و کتابخانه درخواست برای اجرای این فایل نصب شده باشد.

امیدوارم این کمک کند. برای هر گونه سوال، لطفا در تاپیک زیر نظر دهید.

Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

میشه فایل پاورشل رو هم آپدیت کنید؟ما نمی توانیم از node. js در محیط خود استفاده کنیم.

Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

مطمئنا، تیم توسعه ما روی آن کار می کند. در اسرع وقت یک به روز رسانی ارسال خواهد شد.

ممنون از اینکه میفهمی.

Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

آیا به روز رسانی در این مورد؟4 روز گذشته است و من هنوز در هنگام فراخوانی api برای تولید نشانه دسترسی از معجون رفرش توکن که در مصراع پاورشل است، دائماً با شکست مواجه می شوم.

Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ما هنگام استفاده از درخواست فراخوانی برای دریافت داده های API، حلقه اضافه کردیم، همچنان در گزارش ها وقفه های زمانی را مشاهده می کنیم، اما حلقه تا زمانی که موفقیت آمیز باشد به تلاش ادامه می دهد. به نظر می رسد مشکل در سرورهای API سایت 24x7 باشد

Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ما یک اسکریپت powershell را از طریق شناسه ایمیل پشتیبانی خود با شما به اشتراک گذاشته ایم. لطفاً به ما اطلاع دهید که آیا این مشکل را حل می کند یا خیر.

پاسخ: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

از پست شما سپاسگذاریم.

من اکنون یک OAuth 2. 0 Access Token ایجاد کرده ام و یک اسکریپت در Postman برای راه اندازی یک پنجره نگهداری موقت ایجاد کرده ام. قصد من این است که این فرآیند را به عنوان بخشی از خطوط لوله ساخت و انتشار خود در Azure DevOps خودکار کنیم تا بتوانیم در هر زمان که بخواهیم یک برنامه تحت نظارت 24×7 را بدون ایجاد هشدار، خرید با پستچی یا اسکریپت curl، انتشار را انجام دهیم.

مشکلی که من دارم این است که به نظر می رسد توکن دسترسی فقط برای مدت زمان بسیار کوتاهی (ساعت ها) معتبر است، به این معنی که نمی توانم این را به عنوان مرحله ای در چارچوب انتشار خودکار خود بدون تولید یک توکن جدید هر روز ایجاد کنم.

آیا دارم اینجا چیزی را جا می اندازم؟آیا راهی برای اعطای توکن دسترسی (من از کلاینت مبتنی بر وب استفاده می کنم) وجود دارد که مثلاً یک سال دوام داشته باشد؟

پیشاپیش بسیار متشکرم.

Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

توکن Refresh یک توکن دائمی است. پس از انقضای آن (در عرض یک ساعت) باید از نشانه رفرش برای تولید نشانه دسترسی جدید استفاده کنید.

لطفاً «PART 5: GENERATE ACCESS TOKEN FROM REFRESH TOKEN» را در API Doc بررسی کنید

Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

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

Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

آیا URL داده Token (accounts. zoho.com/oauth/v2/token) برای همه مراکز داده یکسان است؟

لطفاً تأیید کنید که آیا برای اروپا یکسان است.

Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

نه ، URL برای هر مرکز داده تغییر می کند. برای اروپا باید از https://accounts. zoho. eu/oauth/v2/token استفاده کنید

Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

چگونه این OAUTH 2. 0 بر ادغام RESP API با ServiceNow تأثیر می گذارد؟

همانطور که می فهمم شما باید هر وقت یک نشانه OAuth ایجاد کنید

Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

اگر از سرویس خارج از جعبه استفاده می کنید ، اکنون ادغام شده است ، به دلیل OAUTH 2. 0 تغییری در آن وجود ندارد. از آنجا که فقط نحوه تماس با API ما اصلاح شده است ، نه چگونه و چه چیزی برای سرویس ارسال می کنیم. همین مورد در مورد همه ادغام های شخص ثالث صدق می کند.

Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

امیدوارم اکنون بتوانید آن را کار کنید. در صورت نیاز به کمک دیگری به ما اطلاع دهید.

پاسخ: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

سلام از سایت 24x7!

در حالی که تولید OAUTH Refresh Token و Grant Token را تولید می کند ، پاسخ از این پس "منقضی می شود". در عوض ، "منقضی شده" دوره زمانی را که در ثانیه به تصویر کشیده شده است ، خواهد داشت. در پاسخ های موجود "منقضی شده" دوره زمانی را در میلی ثانیه نشان می دهد. تمام این نشانه های تازه شده ایجاد شده قبل از 31 ژانویه 2020 همچنان در قالب قدیمی خواهند بود.

پاسخ قبلی:<"access_token":"1000.2deaf8****c85daa2a013a843b10.703ad****8a36cfc5d7b83cf24", "refresh_token":"1000.18e983526f0ca85****d5bb58.1bd8*****a7e439cc1", "expires_in_sec":3600," api_domain":"https://www.zohoapis.com", "token_type": "Bearer", "expires_in": 360000 //in milliseconds>

New response: "access_token":"1000.be42****33ea3a59dc9864079d2.ccd30****5ed02f1a2e8ee8", "refresh_token":"1000.feec****4550f75d2398b27d99d.9689eb9****d92ec7cdffc71", "api-domain":"https://www.zohoapis.com", "token_type":"Bearer", "expires_in":3600 //in seconds>

مثال برای پاسخ به نشانه دسترسی:

Previous response: "access_token": "1000.3a1b3*****546d0072f9e46f.b552ef01*****3d6732f2", "expires_in_sec": 3600 "api_domain": "https://www.zohoapis.com", "token_type": "Bearer", "expires_in": 360000 //in milliseconds>

پاسخ جدید:<"access_token": "1000.3a1b3*****546d0072f9e46f.b552ef01*****3d6732f2", "api_domain": "https://www.zohoapis.com", token_type": "Bearer", "expires_in": 3600 //in seconds>

Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

فقط به این مسئله رسیدید و مدتی را برای من گرفت تا آن را بفهمم (پست کامل را نخوانده بود) ، آیا می توان به عنوان مثال پرونده های Python ("نمونه های نمونه برداری") با تغییرات به روز شد و دوباره تغییر یافت تا دیگران نتوانند "سفر به این نیز ،

Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

با تشکر از شما برای بالا بردن اینما نمونه های Python ، JavaScript و PowerShell را به روز کرده ایم. آنها را در این نظر وصل کرده اید و همچنین زیپ پیوست شده را در نظرات قبلی من به روز کرده اید.

امیدوارم این کمک کند. لطفاً در صورت وجود ، به ما در مورد سوالات اطلاع دهید.

Re: Re: Re: Re: انتقال به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

سلام تیم Site24x7 ،

ما با استفاده از نشانه های Refresh ، برخی از مشکلات آزار دهنده را در اختیار داریم. به نظر می رسد بین رفتار و محدودیت هایی که در مستندات API و رفتار واقعی شرح داده شده است ، عدم تطابق وجود دارد.

بخش مستندات مورد نظر به شرح زیر است:

هر نشانه تازه می تواند حداکثر 30 نشانه دسترسی فعال (غیر منقضی) داشته باشد. هنگامی که کاربر 31th Access Token را ایجاد می کند ، اولین نشانه دسترسی ایجاد شده به طور خودکار حذف می شود تا آخرین مورد را در خود جای دهد.

نسخه کوتاه مسئله ما این است که API حتی قبل از درخواست 31 نشانه ، درخواست های توکن را با "دسترسی انکار" رد می کند. همچنین ، از مستندات فرض می کنم که درخواست 31 نشانه بلافاصله یکی را ایجاد می کند و قدیمی ترین نشانه را در پرواز حذف می کند ، اما این چیزی نیست که ما مشاهده می کنیم. درعوض ، ما قادر به به دست آوردن نشانه های جدید برای چند دقیقه نیستیم ، که-حتی با استفاده از بازده برگشتی-باعث می شود که اتوماسیون های ما اغلب شکست بخورد.

برای توضیح کامل از موضوع ، توضیحات مربوط به مسئله و دو اسکریپت تولید مثل را به عنوان یک Github Gist تهیه کردم که در اینجا یافت می شود:

مشتاقانه منتظر بازخورد شما هستم.

با تشکر و با احترام!

Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

لطفاً توجه داشته باشید که می توانید در یک دقیقه شبیه به نشانه های Refresh به عنوان یک اقدام امنیتی ، حداکثر 5 علامت دسترسی ایجاد کنید. در بعضی موارد ، شما قادر خواهید بود در یک دقیقه 15 نشان دسترسی ایجاد کنید.

"هر نشانه تازه می تواند حداکثر 30 نشانه دسترسی فعال (غیر منقضی شده) داشته باشد. وقتی کاربر 31 ام دسترسی را ایجاد می کند ، اولین نشانه دسترسی ایجاد شده به طور خودکار حذف می شود تا آخرین مورد را در خود جای دهد."بیانیه فوق حاکی از آن است که فقط 30 نشانه دسترسی فعال می توانند به طور همزمان زنده باشند ، اما شما نمی توانید در یک دقیقه 30 یا بیشتر از نشانه های دسترسی تولید کنید.

شما می توانید یک مکان متمرکز برای واکشی Access Token داشته باشید ، که در صورت انقضا یک قدیمی ، نشانه دسترسی جدید ایجاد می کند.

Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

از پاسخ شما متشکرماین حداقل رفتار را توضیح می دهد.

آیا می توانید من را در اسناد و مدارکی که محدودیت های هر دقیقه در آن ذکر شده است ، به من نشان دهید؟به نظر نمی رسد آن را پیدا کنم.

آیا می توان API را برای بازگشت 429 پاسخ مناسب بیش از حد درخواست ها با یک سرصفحه پس از آزمایش مجدد اصلاح کرد؟این امر برای سیستم های خودکار بسیار مفید خواهد بود که بتوانند به درستی از این حد نرخ برخورد کنند. در حال حاضر وضعیت 200 را با دسترسی به پیام رد می کند ، که کمی گیج کننده است.

ما در واقع در صورت امکان از نشانه های دسترسی استفاده می کنیم تا در صورت امکان منقضی شوند ، اما ما برخی از سیستم های خودکار داریم که هنگام راه اندازی ، یک نشانه دسترسی از همان نشانه تازه می گیرند که باعث می شود چندین مورد از این موارد به صورت موازی یا سریع یکی پس از دیگری راه اندازی شود. وادپاسخ های محدود کننده نرخ مناسب مطمئناً در اینجا کمک می کند.

Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

با تشکر از پیشنهاد شما ، ما کد وضعیت را بررسی و به روز خواهیم کرد.

"آیا می توانید من را به جایی در اسناد و مدارکی که در آن محدوده در هر دقیقه ذکر شده است ، نشان دهید؟ به نظر نمی رسد که آن را پیدا کنم."- ما به صراحت این موارد را برای API های خود ذکر نکرده ایم. همچنین بر اساس API متفاوت است. تعداد باید برای استفاده معمولی کافی باشد. همچنین می توانید در مورد استفاده مؤثر به پست جامعه ما مراجعه کنید.

Re: Re: Re: Re: Re: Re: Re: Re: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

لطفاً شناسه مشتری خود را از طریق ایمیل به اشتراک بگذارید: [email protected]. ما می توانیم کد خطا را به تنهایی برای آن شناسه مشتری تغییر دهیم ، به طوری که دیگران را که قبلاً به 200 متکی هستند ، نمی شکند.

پاسخ: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

آیا راهی برای پیگیری شناسه های مشتری یا چیزی وجود دارد که مشتریان بتوانند استفاده API را در حساب خود حسابرسی کنند؟همانطور که امروز است ، ما هیچ راهی برای پیگیری اینکه چه کسی از API استفاده می کند نداریم و به همین ترتیب نمی تواند اطمینان حاصل کند که با ایجاد تغییراتی در حساب خود ، ما چیزها را نمی شکنیم.

ما اخیراً مسئله ای داشتیم که در آن یک حساب کاربری را از مدیر به اپراتور رها کردیم و یک API (OAUTH) به حساب آن گره خورده بود و این یک قطعه مهم از فرآیند انتشار تولید ما را شکست که مانیتورها را در Site24x7 ایجاد و نگهداری می کند. ما تا زمان حل مسئله نتوانستیم نسخه های تولید را انجام دهیم.

به علاوه هیچ راهی برای گفتن اینکه چند چیز در آنجا از طریق API به هم وصل می شود وجود ندارد.

در ابزارهای دیگر ما یک صفحه API مرکزی داریم که افراد برای ایجاد ادغام های جدید به آنجا می روند و آنها باید توضیحی درباره آنچه از آن استفاده می کنند ، بگذارند. در این صفحه موارد مهمی مانند توضیحات ، تاریخ ایجاد شده ، آخرین تاریخ استفاده شده و ایجاد شده توسط.

پاسخ: مهاجرت به OAuth 2. 0 برای احراز هویت Site24x7 REST APIs

ما در تاریخ 31 آگوست 2019 از مدل Authtoken به OAuth نقل مکان کرده ایم. برنامه اولیه این بود که تا 30 نوامبر 2019 پشتیبانی از Authtokens موجود را کنار بگذاریم ، اما بر اساس چند درخواست مشتری ، ما پشتیبانی را گسترش دادیم. یک سال است که ما این پشتیبانی را گسترش داده ایم ، از این رو از 28 فوریه 2021 ما از Authtokens موجود حمایت نمی کنیم.

برای شروع با OAUTH 2. 0 ، می توانید مستندات API ما را ارجاع دهید.

ما همچنین اسکریپت های نمونه ای برای زبانها داریم:

If you want to check whether you're using an authtoken in your account for any integration or automation, you can navigate to -> Admin -> developer ->API

اگر در حال دریافت پیام هشدار دهنده برای مهاجرت به OAuth هستید ، ممکن است یکی از کاربران حساب شما در حال برقراری تماس API باشد/هر اتوماسیون مبتنی بر AuthTokens از حساب شما است.

برای کسب اطلاعات بیشتر در مورد آن تماس های API می توانید با [email protected] تماس بگیرید و بر این اساس آنها را به OAUTH منتقل کنید.