O2 SMS Connector + Dynamics 365 / Dataverse — intake snapshot

Toto je veřejný intake snapshot k výzkumu. Finální doporučení pro architekturu a práci s certifikátem je publikované zde:

• O2 SMS Connector pro Dynamics 365 / Dataverse: doporučení implementace

Ověřená startovní fakta z O2 dokumentace

• O2 u služby SMS Connector výslovně uvádí, že napojení na firemní aplikace probíhá přes API.
• V sekci Technické podrobnosti SMS Connector O2 uvádí, že komunikace mezi aplikací zákazníka a O2 probíhá na bázi IP protokolu přes internet nebo pevné připojení.
• O2 výslovně uvádí, že transportním protokolem je HTTPS.
• O2 výslovně uvádí, že totožnost zákazníka ověřuje na bázi klientského certifikátu.
• O2 uvádí, že certifikát lze buď vygenerovat jejich nástrojem, nebo použít certifikát od veřejné certifikační autority.
• V aktivačních pokynech O2 uvádí, že zákazník posílá veřejnou část certifikátu .pem a soukromou část .p12 si ukládá do aplikace, která bude SMS přes SMS Connector odesílat.
• O2 uvádí dva typy aplikačního rozhraní: webová služba a HTTP GET/POST s jednoduchou syntaxí.
• Na veřejné stránce jsou ke stažení nejméně tyto technické soubory:
• Technicky_popis_rozhrani_web_services_sluzby_SMS_Connector_ENG.pdf
• Technicky_popis_rozhrani_HTTP_GET_sluzby_SMS_Connector_ENG.pdf
• Deployment Specific Parameters v0.9.2_partners.pdf
• SMS_Connector_Plus_EMP_UserManWS_01.02.pdf

Proč je to zajímavé pro Dataverse plugin

Hlavní otevřená otázka není jen „jak zavolat API“, ale hlavně:

1. jak přesně O2 používá klientský certifikát při requestu,
2. zda Dataverse plugin umí bezpečně a provozně rozumně pracovat se soukromým klíčem / client certificate,
3. jestli dává smysl volat O2 přímo z pluginu, nebo raději přes middleware.

Konkrétní výzkumné otázky

1. Jak přesně vypadají endpointy, request/response formát a autentizační model O2 SMS Connectoru?
2. Je klientský certifikát povinný pro samotné volání API, nebo jen pro onboarding/whitelisting?
3. Jaká je očekávaná práce se soukromým klíčem a jaké formáty/algoritmy O2 vyžaduje?
4. Jaká omezení má Dynamics 365 / Dataverse plugin pro práci s klientským certifikátem a outbound HTTPS volání?
5. Jaká architektura je nejbezpečnější a nejpraktičtější: přímé volání z pluginu, Azure Function / API middleware, nebo jiná mezivrstva?

Vytvořené tasky

• t_20d07033 — research: O2 SMS Connector PDF manuály + Dataverse certifikátový kontext
• t_888132fb — analysis: doporučení pro O2 SMS Connector implementaci v Dynamics 365 / Dataverse
• t_4e21691e — review/fixup: O2 SMS Connector + Dataverse plugin certifikáty

Oficiální zdroje

• O2 produktová stránka: https://www.o2.cz/podnikatele-a-firmy/volani/sms-connector#technicke-podrobnosti-a-dokumentace-a307151
• O2 ZIP nástroj pro generování certifikátu: https://www.o2.cz/podnikatele-a-firmy/hp-d2/volani-d2/sms-connector/aplikace-pro-generovani-certifikatu/O2_mp_key.zip
• O2 PDF — web services: https://www.o2.cz/podnikatele-a-firmy/-a21976?field=data&_linka=a1162969
• O2 PDF — HTTP GET/POST: https://www.o2.cz/podnikatele-a-firmy/-a49808?field=data&_linka=a1162983
• O2 PDF — deployment parameters: https://www.o2.cz/podnikatele-a-firmy/-a49804?field=data&_linka=a180428
• O2 PDF — user manual WS: https://www.o2.cz/podnikatele-a-firmy/-a49802?field=data&_linka=a180426

Poznámka k rozsahu

Tato stránka je jen veřejné zadání a startovní ověřená fakta. Finální doporučení bude publikované zvlášť až po prostudování PDF dokumentace a vyhodnocení v kontextu Dataverse pluginu.