본문으로 이동

문서

OpenConnector 카탈로그 범위와 검증 상태

제공자 카탈로그, 로컬 Action 실행기와 실제 외부 API 검증의 차이 및 사용 전 확인 사항을 알아보세요.

유지 관리: OOMOL·

소스 확인일: 2026-09-09. 예제는 링크된 소스 리비전과 대조했습니다. 실제 외부 API 검증을 의미하지 않으며, 배포된 버전과 다를 수 있습니다.

카탈로그 정의

카탈로그 항목은 제공자, 인증 방식, Action과 스키마를 설명합니다. 항목이 있다는 사실만으로 모든 Action이 현재 배포에서 실행된다는 뜻은 아닙니다.

로컬 실행

실행기는 runtime에서 Action을 구현합니다. 링크된 리비전의 구현을 읽고 실행 중인 버전에 포함되어 있는지 확인하세요.

외부 API 검증

스키마나 실행기가 있다고 외부 API 호출 성공이 입증되지는 않습니다. 검증 기록을 확인하고 자신의 계정, 권한, 리소스로 해당 Action을 테스트하세요.

호출 실패 시 점검

runtime URL과 토큰, 선택한 계정, 필수 입력, 제공자 권한을 확인하세요. 응답의 executionId로 민감 정보를 가린 실행 로그를 확인하세요. 이미 제공자 데이터를 변경했을 수 있는 Action을 자동으로 반복하지 마세요.

실제 검증 범위 기록

검사마다 런타임 리비전 또는 이미지, Action ID, 계정 유형, scopes, 민감하지 않은 입력, 결과와 날짜를 기록하세요. 소스 검토, 로컬 실행기 테스트, 실제 공급자 API 호출을 구분하고 자격 증명, 비공개 콘텐츠, 민감 정보가 가려지지 않은 로그를 공개하지 마세요.