Integrálás a farmtevékenységek adatszolgáltatójával
Az Azure Data Manager for Agriculture támogatja az összekötőket a végfelhasználók adatainak számos farmgép-adatforrásból való kényelmes szinkronizálásához. A beállítás magában foglalja az oAuth-folyamat konfigurálását a farmtevékenységek adatszolgáltatóival való integráció előfeltételeként, valamint egy fiókonkénti, transzparens hozzájárulási lépést, amely kezeli a kezdeti és növekményes adatszinkronizálást az ADMA-adattulajdon naprakészen tartásához.
Megjegyzés:
Az 1–3. lépés a szolgáltatónkénti egyszeri kezdeti konfiguráció része. Az integrálást követően minden végfelhasználó használhatja a meglévő oAuth-munkafolyamatot, és meghívhatja a konfigurációs API-t (4. lépés) felhasználónként (PartyID) a hozzáférési jogkivonat lekéréséhez.
Szolgáltató beállítása
Az itt látható példafolyamat a Climate FieldView-t használja
1. lépés: Alkalmazás létrehozása
Ha az alkalmazás még nincs regisztrálva a Climate Fieldview szolgáltatásban, nyissa meg a FieldView portált , és küldje el az űrlapot. Miután a FieldView feldolgozta a kérést, elküldik a kérést client_id
, amelyet client_secret
ADMA-példányonként egyszer fog használni a FieldView-hoz.
2. lépés: Szolgáltató konfigurálása
oAuthProvider
Az API használatával hozza létre vagy frissítse az oAuth-szolgáltatót (pl. FIELDVIEW) az újonnan létrehozott alkalmazás megfelelő hitelesítő adataival.
API-dokumentáció: oAuthProviders – Létrehozás vagy frissítés
Nem kötelező lépés: A művelet elvégzése után futtathatja a oAuthProviders_Get annak ellenőrzéséhez, hogy az alkalmazás regisztrálva van-e. Most az Azure Data Manager for Agriculture-példányban létrehozott összes fél használhatja a FieldView-t szolgáltatóként a farmtevékenységek adatainak lekéréséhez.
3. lépés: Végpontkonfiguráció
Felhasználóátirányítási végpont: Erre a végpontra szeretné átirányítani a felhasználókat az oAuth-folyamat befejezése után. Ezt a végpontot Ön hozza létre, és az ADMA-nak adja meg az oauth/tokens/:connect API-hoz hasonlóan userRedirectLink
.
Regisztrálja az oAuth visszahívási végpontot az Alkalmazás a Climate FieldView portálon.
Végfelhasználói fiók beállítása
4. lépés: Parti (végfelhasználói) integráció
Ha egy fél (végfelhasználó) a webhelyére ér, ahol a felhasználói művelet várható (például Csatlakozás a FieldView gombra), az alábbi módon hívja meg oauth/tokens/:connect
az API-t, hogy az oAuth-szolgáltató (pl. Climate FieldView) bejelentkezési URI-ját visszavezhesse a végfelhasználói oAuth-folyamat elindításához.
API-dokumentáció: oAuthTokens – OAuth Csatlakozás ion Link lekérése
Miután az oauth/tokens/:connect
API sikeresen visszaadta a hivatkozást, a végfelhasználó erre a oauthAuthorizationLink
hivatkozásra kattintva befejezi az oAuth-folyamatot (például: A Climate FieldView esetében a felhasználó egy FieldView hozzáférési hozzájárulást és bejelentkezési oldalt kap). A bejelentkezés befejezése után az ADMA átirányítja a felhasználót az ügyfél (userRedirectLink
) által biztosított végpontra az alábbi lekérdezési paraméterekkel az URL-címen
- állapot (sikeres/sikertelen)
- állapot (opcionális sztring a felhasználó egyedi azonosításához az ügyfél végén)
- üzenet (nem kötelező sztring)
- errorCode (hiba/hiba esetén küldött opcionális sztring) a paraméterekben.
Megjegyzés:
Ha az API a 404-et adja vissza, az azt jelenti, hogy az oAuth-folyamat meghiúsult, és az ADMA nem tudta beszerezni a hozzáférési jogkivonatot.
5. lépés: Hozzáférési jogkivonat adatainak ellenőrzése (nem kötelező)
Ez a lépés nem kötelező, csak annak ellenőrzéséhez, hogy egy adott felhasználó vagy felhasználók listája esetében a szükséges érvényes hozzáférési jogkivonatot beszerezték-e. Ezt úgy teheti meg, hogy meghívja az oauth/tokens
API-t, hogy ellenőrizze a bejegyzést isValid: true
a válasz törzsében.
API-dokumentáció: oAuthTokens – Lista
Ez a lépés jelzi a felhasználó oAuth-folyamatának sikeres befejezését. A felhasználó most már teljesen be van állítva egy új FarmOperationsDataJob aktiválásához, hogy megkezdje a farmtevékenységek adatainak lekérését a Climate FieldView-ból.