Integrace s Zprostředkovatel dat aktivit farmy

Azure Data Manager pro zemědělství podporuje konektory pro pohodlnou synchronizaci dat koncových uživatelů z celé řady zdrojů dat strojů farmy. Nastavení zahrnuje konfiguraci toku oAuth jako předpoklad pro integraci se všemi poskytovateli dat farmových aktivit spolu s transparentním krokem souhlasu pro jednotlivé účty, který zpracovává počáteční a přírůstkovou synchronizaci dat, aby byla datová aktiva ADMA aktuální.

Poznámka:

Kroky 1 až 3 jsou součástí počáteční konfigurace jednorázového zprostředkovatele. Po integraci budete moct všem koncovým uživatelům povolit použití existujícího pracovního postupu oAuth a volání konfiguračního rozhraní API (krok 4) na uživatele (PartyID) k načtení přístupového tokenu.

Nastavení zprostředkovatele

Příklad toku zde používá Climate FieldView.

Krok 1: Vytvoření aplikace

Pokud vaše aplikace ještě není zaregistrovaná ve službě Climate Fieldview, přejděte na portál FieldView a odešlete formulář. Jakmile FieldView zpracuje vaši žádost, odešlou vaši client_id a client_secret kterou použijete jednou pro instanci ADMA pro FieldView.

Krok 2: Konfigurace zprostředkovatele

oAuthProvider Pomocí rozhraní API vytvořte nebo aktualizujte zprostředkovatele oAuth (např. FIELDVIEW) příslušnými přihlašovacími údaji nově vytvořené aplikace.

Dokumentace k rozhraní API: oAuthProviders – Vytvoření nebo aktualizace

Volitelný krok: Po dokončení operace můžete spustit oAuthProviders_Get a ověřit, jestli je aplikace zaregistrovaná. Teď můžou všechny strany vytvořené v instanci Azure Data Manageru pro zemědělství použít FieldView jako zprostředkovatele k načtení dat farmových aktivit.

Krok 3: Konfigurace koncového bodu

Koncový bod přesměrování uživatele: Tento koncový bod je místo, kam mají být vaši uživatelé přesměrováni po dokončení toku oAuth. Tento koncový bod vygenerujete a poskytnete ADMA jako userRedirectLink v rozhraní API oauth/tokens/:connect. Zaregistrujte koncový bod zpětného volání oAuth ve vaší aplikaci na portálu Climate FieldView.

Nastavení účtu koncového uživatele

Krok 4: Integrace strany (koncového uživatele)

Když strana (koncový uživatel) přejde na webovou stránku, kde se očekává akce uživatele (např. Připojení na tlačítko FieldView), zavolejte oauth/tokens/:connect rozhraní API následujícím způsobem, abyste získali přihlašovací identifikátor URI poskytovatele oAuth (např. Climate FieldView), aby se spustil tok oAuth koncového uživatele.

Dokumentace k rozhraní API: oAuthTokens – Získání odkazu na OAuth Připojení ion

oauth/tokens/:connect Jakmile rozhraní API úspěšně vrátí oauthAuthorizationLinkodkaz , koncový uživatel klikne na tento odkaz a dokončí tok oAuth (např. pro climate FieldView se uživateli zobrazí souhlas s přístupem FieldView a přihlašovací stránka). Po dokončení přihlášení přesměruje ADMA uživatele na koncový bod poskytnutý zákazníkem (userRedirectLink) s následujícími parametry dotazu v adrese URL.

1. stav (úspěch/selhání)
2. state (volitelný řetězec pro jedinečnou identifikaci uživatele na straně zákazníka)
3. message (volitelný řetězec)
4. errorCode (volitelný řetězec odeslaný pro chybu nebo chybu) v parametrech.

Poznámka:

Pokud rozhraní API vrátí hodnotu 404, znamená to, že tok oAuth selhal a ADMA nemohl získat přístupový token.

Krok 5: Kontrola informací o přístupových tokenech (volitelné)

Tento krok je nepovinný, pouze pokud chcete ověřit, jestli pro daného uživatele nebo seznam uživatelů došlo k získání požadovaného platného přístupového tokenu nebo ne. Můžete to provést voláním oauth/tokens rozhraní API a zkontrolovat položku isValid: true v textu odpovědi.

Dokumentace k rozhraní API: oAuthTokens – List

Tento krok označuje úspěšné dokončení toku oAuth pro uživatele. Teď je uživatel nastavený tak, aby aktivoval novou farmuOperationsDataJob , aby začal stahovat data aktivit farmy z climate FieldView.