팜 활동 데이터 공급자와 통합

아티클
10/26/2023

Azure Data Manager for Agriculture은 다양한 팜 기계 데이터 원본에서 최종 사용자의 데이터를 편리하게 동기화하는 커넥터를 지원합니다. 설정에는 ADMA 데이터 자산을 최신 상태로 유지하기 위해 초기 및 증분 데이터 동기화를 처리하는 계정별 투명한 동의 단계와 함께 모든 팜 활동 데이터 공급자와 통합하기 위한 필수 조건으로 oAuth 흐름을 구성하는 작업이 포함됩니다.

참고 항목

1~3단계는 공급자당 일회성 초기 구성의 일부입니다. 통합되면 모든 최종 사용자가 기존 oAuth 워크플로를 사용할 수 있도록 설정하고 사용자별 구성 API(4단계)를 호출하여 액세스 토큰을 검색할 수 있습니다.

공급자 설정

여기서 예제 흐름은 Climate FieldView를 사용합니다.

1단계: 앱 만들기

애플리케이션이 Climate Fieldview에 아직 등록되지 않은 경우 FieldView 포털로 이동하여 양식을 제출합니다. FieldView가 요청을 처리하면 해당 요청을 보내고 client_idclient_secret FieldView에 대한 ADMA 인스턴스당 한 번 사용할 수 있습니다.

2단계: 공급자 구성

API를 oAuthProvider 사용하여 새로 만든 앱의 적절한 자격 증명으로 oAuth 공급자(예: FIELDVIEW)를 만들거나 업데이트합니다.

API 설명서: oAuthProviders - 만들기 또는 업데이트

선택적 단계: 작업이 완료되면 oAuthProviders_Get 실행하여 애플리케이션이 등록되었는지 여부를 확인할 수 있습니다. 이제 Azure Data Manager for Agriculture 인스턴스에서 만든 모든 당사자가 FieldView를 공급자로 사용하여 팜 활동 데이터를 가져올 수 있습니다.

3단계: 엔드포인트 구성

사용자 리디렉션 엔드포인트: 이 엔드포인트는 oAuth 흐름이 완료되면 사용자를 리디렉션할 위치입니다. 이 엔드포인트는 사용자가 생성하고 oauth/tokens/:connect API에서와 같이 userRedirectLink ADMA에 제공됩니다. Climate FieldView 포털에서 앱에 oAuth 콜백 엔드포인트를 등록합니다.

최종 사용자 계정 설정

4단계: 파티(최종 사용자) 통합

파티(최종 사용자)가 사용자 작업이 필요한 웹 페이지에 도착하면(예: FieldView 단추로 커넥트) 아래 방식으로 API를 호출 oauth/tokens/:connect 하여 oAuth 공급자(예: Climate FieldView) 로그인 URI를 다시 가져와 최종 사용자 oAuth 흐름을 시작합니다.

API 설명서: oAuthTokens - OAuth 커넥트ion Link 가져오기

API가 oauth/tokens/:connect 성공적으로 반환oauthAuthorizationLink되면 최종 사용자가 이 링크를 클릭하여 oAuth 흐름을 완료합니다(예: Climate FieldView의 경우 사용자에게 FieldView 액세스 동의 및 로그인 페이지가 제공됩니다). 로그인이 완료되면 ADMA는 URL에 다음 쿼리 매개 변수를 사용하여 고객이userRedirectLink 제공한 엔드포인트로 사용자를 리디렉션합니다.

상태(성공/실패)
상태 (고객 끝에서 사용자를 고유하게 식별하는 선택적 문자열)
message (선택적 문자열)
매개 변수의 errorCode (오류/오류에 대해 전송된 선택적 문자열)입니다.

참고 항목

API가 404를 반환하는 경우 oAuth 흐름이 실패하고 ADMA가 액세스 토큰을 획득할 수 없음을 의미합니다.

5단계: 액세스 토큰 정보 확인(선택 사항)

이 단계는 선택 사항이며, 지정된 사용자 또는 사용자 목록에 필요한 유효한 액세스 토큰이 획득되었는지 여부를 확인하기 위한 것입니다. 이 작업은 API를 호출하여 oauth/tokens응답 본문의 항목 isValid: true 에 대한 검사 통해 수행할 수 있습니다.

API 설명서: oAuthTokens - 목록

이 단계는 사용자에 대한 oAuth 흐름의 성공적인 완료를 표시합니다. 이제 사용자는 새 FarmOperationsDataJob 을 트리거하여 Climate FieldView에서 팜 활동 데이터 끌어오기를 시작하도록 모든 설정을 지정합니다.

Share via