Есептік жазбадағы ОАұтһ және МЦП қосымшалары

ОАұтһ және МЦП қосымшалары бөлімі Планфіх аккаунтына сыртқы қосымшаларды қосу параметрлерін қамтиды.

Ашыңыз: Аццоұнт манагемент → АПЫ → ОАұтһ анд МЦП аппліцатіонс. Бұл бөлім аккаунт әкімшілеріне және техникалық әкімшілерге қолжетімді.

Ол үш бөлімнен тұрады:

МЦП — МЦП серверінің мекенжайы және қосылуға қысқаша нұсқаулар;
Аппліцатіонс оунед бy тһіс аццоұнт — ағымдағы аккаунт үшін арнайы жасалған ОАұтһ қосымшалары;
Тһірд-партy аппліцатіонс — жалпы саясат және аккаунтта нақты мақұлданған үшінші тарап қосымшалары.

МЦП

Бұл жерде Планфіх МЦП ҰРЛ көрсетіледі:

https://mcp.planfix.com/mcp

Қолданушы әдетте осы ҰРЛ-ді үйлесімді МЦП клиентке қосуды және ОАұтһ арқылы кіруді аяқтауды қажет етеді. Аккаунт атауы Планфіх бетінде таңдалады және ҰРЛ-ге кірмейді. Құрамдастырылған нұсқаулар үшін Планфіх МЦП қараңыз.

Аппліцатіонс оунед бy тһіс аццоұнт

Интеграция тек ағымдағы аккаунтқа арналған кезде және сыртқы клиентке алдын ала анықталған client_id қажет болғанда аккаунтқа тиесілі қосымшаны жасаңыз.

Аккаунтқа тиесілі қосымша:

басқа аккаунттарға қосыла алмайды;
үшінші тарап қосымша саясатына қарамастан өзінің иесі аккаунтында қолжетімді;
жалпы ОАұтһ соңғы нүктелерін пайдаланады;
таңдалған масштабтар аясында РЕСТ АПЫ немесе МЦП-пен жұмыс істей алады.

Қосымша жасау

Цреате аппліцатіон таңдаңыз.
Анық атау мен сипаттама енгізіңіз.
ОАұтһ клиент түрін таңдаңыз.
Клиенттің редірецт ҰРЫ-ларын қосыңыз.
Қажетті минималды қол жеткізу деңгейлерін таңдаңыз.
Қосымшаны сақтап, жасалған тіркелгілерді көшіріп алыңыз.

Клиент түрі	Қашан қолдану қажет
Пұбліц	Мобильді, десктоп немесе браузерлік қосымша, немесе жергілікті МЦП клиенті. Құпия сөз (сецрет) шығарылмайды; авторизация ағынын ПКЦЕ қорғайды.
Цонфідентіал	Клиент құпиясын сенімді түрде сақтай алатын серверлік қосымша. Құпияны клиент жағындағы кодқа, мобильді қосымшаға немесе таралымды конфигурация файлына ешқашан қоспаңыз.

Цонфідентіал типті қосымша жасалғаннан кейін клиент құпиясы көрсетіледі. Оны сенімді құпияларды басқару жүйесіне сақтаңыз.

Редірецт ҰРЫ-лар және рұқсаттар

Тұрақты веб-қосымшалар үшін https пайдаланыңыз. http тек localhost немесе 127.0.0.1 сияқты лоопбацк хосттары үшін ғана рұқсат етіледі.

Интеграция үшін тек қажетті масштабтарды таңдаңыз. Масштабтар қосымшаның қолжетімділігін шектейді, бірақ қосымшаны қосқан қолданушының рұқсаттарын кеңейтпейді.

Редірецт ҰРЫ-ларды немесе масштабтарды өзгерткен кезде қосымшаның мақұлдау нұсқасы өзгереді және бұрын берілген токендер қосымшаға сәйкес келмейді. Пайдаланушыларға қайта қосылу қажет болады.

Қосымшаны басқару

Қосымша картасынан сіз:

атауын, сипаттамасын, редірецт ҰРЫ-ларын және масштабтарды өңдей аласыз;
қосымшаны өшіріп, қайта қосуға болады;
цонфідентіал клиенттің клиент құпиясын (сецрет) жаңарта аласыз.

Құпияны жаңартқаннан кейін бұрынғы клиент құпиясы дереу жұмысын тоқтатады. Жаңа құпияны көшіріп алып, интеграцияның серверлік конфигурациясын жаңартыңыз.

Қосымшаны өшіру авторизацияны және шығарылған токендерді қолдануды блоктайды. Оны өшірмес бұрын ешқандай бизнес-процестер оған тәуелді емес екеніне көз жеткізіңіз.

Тһірд-партy аппліцатіонс

Үшінші тарап қосымшаларына серіктестерге тиесілі қосымшалар, жарияланған қосымшалар және ЦЫМД немесе ДЦР арқылы тіркелген МЦП клиенттері жатады.

Үшінші тарап қосымша саясаты

Саясат	Нәтиже
Аллоу пұблісһед аппліцатіонс	Планфіх жариялаған қосымшалар жеке мақұлдаусыз қолжетімді. Жеке серіктес қосымшалар және автоматты түрде тіркелген МЦП клиенттері әлі де әкімші мақұлдауын талап етеді.
Аппровед аппліцатіонс онлy	Әрбір үшінші тарап қосымшасы әкімшінің нақты мақұлдауын талап етеді.
Блоцк тһірд-партy аппліцатіонс	Үшінші тарап ОАұтһ және МЦП қосымшалары блокталады. Аккаунтқа тиесілі қосымшалар жұмысын жалғастырады.

Әр интеграцияны жеке қарастыру қажет болатын аккаунттар үшін Аппровед аппліцатіонс онлy ұсынылады.

Қосымшаны мақұлдау

Мақұлдау сұранысы екі жолмен пайда болуы мүмкін:

қолданушы ОАұтһ қосылымын бастайды және Планфіх мақұлдау қажет екенін хабарлайды;
серіктес әкімшіге қосымшаға тікелей сілтеме жібереді.

Қосымшаны мақұлдамас бұрын тексеріңіз:

оның атауын, сипаттамасын және иесін;
оның редірецт ҰРЫ-ы немесе цаллбацк хостын;
сұралған масштабтарды;
қызметкерлерге бұл интеграция қажет пе.

Әкімші мақұлдауы аккаунтқа қолданылады, бірақ әрбір қолданушы автоматты түрде қосылмайды. Әр қызметкер жеке өз атынан кіріп, келісім береді. Егер әкімші қосымшаны өзі қоса жатса, Аппрове анд цоннецт екі әрекетті де орындайды.

Егер әзірлеуші үшінші тарап қосымшасының редірецт ҰРЫ-ларын немесе масштабтарын өзгерткен болса, жаңа нұсқаны қайта мақұлдау қажет.

Мақұлдауды қайтару

Аккаунт үшін қосымшаны блоктау үшін оны мақұлданған тізімнен тауып, рұқсатты қайтарыңыз. Бұл аккаунттағы қолданушыларға қатысты ОАұтһ токендерін жояды.

Саясат Аллоу пұблісһед аппліцатіонс болғанда, нақты мақұлдауды қайтару жарияланған қосымшаны блоктамайды, себебі жалпы саясат оны әлі де рұқсат етеді. Қосымшаны блоктау үшін Аппровед аппліцатіонс онлy немесе Блоцк тһірд-партy аппліцатіонс таңдаңыз.

Жеке қолданушы қосылымдары

Аккаунт мақұлдауы мен жеке қолданушының қосылымы — бөлек бақылау деңгейлері.

Қызметкер өз жеке ОАұтһ қосылымдарын көріп, жоя алады:

Өз қолданушы картасын ашыңыз.
Сессіон манагемент бөліміне өтіңіз.
Қосымшаны табыңыз; МЦП қосылымдары МЦП деп белгіленген.
Сессияны өшіріңіз.

Сессияны жою байланысты токендерді алып тастайды. Қол жеткізуді қалпына келтіру үшін қолданушы ОАұтһ авторизациясын қайта орындауы қажет.

Әкімшіге ұсыныстар

Әр интеграцияны жеке талқылау қажет болса, Аппровед аппліцатіонс онлy пайдаланыңыз.
Тек қана атауын емес, қосымшаның иесін және редірецт ҰРЫ-ын тексеріңіз.
Мәліметтерді өзгерту мен жоюға қатысатын масштабтар үшін ең аз қажетті масштабтарды мақұлдаңыз.
Үшінші тарап қосымшалар тізімін периодтық түрде қарап, пайдаланылмаған қосымшаларды өшіріңіз.
Жергілікті және десктоп клиенттер үшін пұбліц клиент түрін, серверлік интеграциялар үшін цонфідентіал түрін пайдаланыңыз.
Егер цонфідентіал қосымшаның тіркелгілері бұзылуы мүмкін деп есептесеңіз, құпиясын дереу жаңартыңыз және қажет болса интеграцияны қайта қосыңыз.

МЦП