이 문서에서는 Amazon S3와 Knowledge Base를 연동하기 위해 다음 작업을 진행합니다.2.
IAM 사용자의 Access Key와 Secret Access Key 생성
3.
확인한 정보를 Knowledge Base에 입력
연동 전 확인 사항#
Amazon S3 연동을 진행하려면 다음 권한과 정보가 필요합니다.(1) 필요한 관리자 권한#
AWS에 IAM 사용자를 생성하고 IAM 사용자의 Access Key ID / Secret Access Key를 발급할 수 있는 담당자가 필요합니다.조직의 보안 정책에 따라 애플리케이션 등록 담당자와 AWS 관리자의 협조가 필요할 수 있습니다.(2) 연동에 필요한 정보#
연동 과정에서 다음 정보를 생성하거나 확인합니다.| 항목 | 설명 |
|---|
| 버킷 이름 | Knowledge Base에 연결할 Amazon S3 버킷의 이름 |
| 리전 | 해당 S3 버킷이 위치한 AWS 리전 |
| Access Key | S3에 접근하기 위해 사용하는 IAM 사용자의 Access Key ID |
| Secret Access Key | Access Key와 함께 인증에 사용하는 IAM 사용자의 비밀 키 |
S3 연동하기#
1. IAM 사용자 생성하기#
2.
IAM을 검색하여 IAM 서비스로 이동합니다.
6.
권한 정책에서 AmazonS3ReadOnlyAccess 정책을 생성합니다
2. IAM 사용자의 Access Key와 Secret Access Key 생성하기#
등록한 애플리케이션이 SharePoint 문서를 조회할 수 있도록 API 권한을 설정합니다.1.
생성된 IAM 사용자의 상세 화면으로 들어가서 액세스 키 만들기를 클릭합니다
2. 사용사례로 서드 파티 서비스를 선택합니다3.
액세스 키를 설명할 수 있는 태그를 입력합니다(선택 사항)
4.
생성된 Access Key와 Secret Access Key를 확인합니다
Secret Access Key는 생성 직후 표시되는 값을 안전한 장소에 복사해 보관해야 합니다.
이후에는 동일한 값을 다시 확인할 수 없으므로, 분실한 경우 새로운 Secret Access Key을 생성해야 합니다.
3. Knowledge Base에 연동 정보 입력하기#
| 옵션 | 선택 기준 |
|---|
| Amazon S3 | AWS에서 제공하는 Amazon S3 버킷을 연결하는 경우 선택합니다. |
| S3 호환 | AWS가 아닌 스토리지 중 Amazon S3 API와 호환되는 오브젝트 스토리지를 연결하는 경우 선택합니다. 예: MinIO, Oracle Object Storage, Naver Cloud Object Storage(NCP) 등 |
AWS 콘솔에서 생성한 S3 버킷을 연결하는 경우에는 Amazon S3를 선택해주세요.
MinIO, Oracle, NCP 등 별도의 스토리지 서비스를 사용하면서 S3 API 방식으로 연결하는 경우에는 S3 호환을 선택해주세요.
2.
STORM Knowledge Base의 S3 연동 화면에서 앞서 확인한 정보를 입력합니다.
S3의 버킷의 이름과 리전은 속성 탭에서 확인하실 수 있습니다
4. 연동 상태 확인하기#
연동이 완료되면 Knowledge Base에서 S3의 폴더와 문서를 확인할 수 있습니다.최초 연동 시 문서의 수와 용량에 따라 수집과 학습에 시간이 걸릴 수 있습니다. 문서는 수집된 후 파싱과 인덱싱 과정을 거쳐 에이전트가 검색할 수 있는 상태로 전환됩니다.이후 S3에서 발생한 문서의 추가·수정·이동·삭제 사항은 설정된 동기화 주기에 따라 Knowledge Base에 반영됩니다.연동에 실패한 경우 다음 항목을 확인해 주세요.Access Key와 Secret Access Key가 올바른지 확인해주세요
Access Key가 비활성화되었거나 삭제되지 않았는지 확인해주세요
IAM 사용자에 연결할 S3 버킷을 조회할 수 있는 권한이 부여되어 있는지 확인해주세요
버킷 정책이나 기타 AWS 권한 설정에서 해당 IAM 사용자의 접근을 차단하고 있지 않은지 확인해주세요
