기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Confluence에 대한 기본 인증 설정
<a name="kb-managed-confluence-basic-setup"></a>

기본 인증(`BASIC`)은 Confluence 데이터 소스에 권장되는 인증 방법입니다. 커넥터는 Confluence 사용자의 이메일 주소와 Atlassian API 토큰(암호 대신 사용됨)으로 로그인합니다. 문서 수준 액세스 제어(ACLs를 지원하는 유일한 인증 방법입니다. ACLs에는 동일한 보안 암호에 Atlassian 조직 관리자 자격 증명도 필요합니다.

## 1단계: Atlassian API 토큰 생성
<a name="kb-managed-confluence-basic-step1"></a>

커넥터에서 사용할 액세스 권한이 있는 Confluence 사용자 계정을 사용합니다. 계정은 크롤링하려는 모든 스페이스, 페이지 및 블로그 게시물에 액세스할 수 있어야 합니다.

1. Confluence 사용자 계정으로 [id.atlassian.com](https://id.atlassian.com/manage-profile/security/api-tokens) 로그인합니다.

1. **API 토큰 생성을** 선택하고 레이블을 입력한 다음 **생성을** 선택합니다.

1. API 토큰을 즉시 복사하고 안전하게 저장합니다. 토큰은 한 번만 표시됩니다.

자세한 내용은 Atlassian 웹 사이트에서 [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/#Create-an-API-token)를 참조하세요.

## 2단계: (ACLs 경우) Atlassian 조직 관리자 자격 증명 가져오기
<a name="kb-managed-confluence-basic-step2"></a>

문서 수준 액세스 제어를 활성화할 계획이 없는 경우이 단계를 건너뜁니다.

문서 수준 액세스 제어에는 사용자 수준 API 토큰 외에도 Atlassian 조직 관리자 자격 증명이 필요합니다. 관리자 자격 증명을 사용하면 개별 이메일 가시성 설정에 관계없이 Amazon Bedrock이 조직의 사용자 및 그룹 멤버십을 확인할 수 있습니다. 관리자 자격 증명은 사용자 API 토큰과 다르며 Atlassian 조직 관리자가 제공해야 합니다.

세 가지 값이 필요합니다.


**Atlassian 조직 관리자 값**  

| 값 | 얻는 방법 | 
| --- | --- | 
| adminApiKey | read:directories:admin 및 read:workspaces:admin 범위가 있는 Atlassian 조직 API 키입니다. 설정 → API 키(org 관리자만 해당)admin.atlassian.com에서 생성합니다. | 
| organizationId | Atlassian 조직의 UUID입니다. 에 로그인admin.atlassian.com하고 URL에서 ID를 복사합니다admin.atlassian.com/o/{{{orgId}}}. | 
| directoryId | Confluence 워크스페이스에 대한 사용자 디렉터리의 UUID입니다. 를 보유자 토큰adminApiKey으로 사용하여 Atlassian Admin Workspace API(GET /v2/orgs/{{{orgId}}}/workspaces)로 검색합니다. Confluence 사이트에 해당하는 워크스페이스directoryId에서를 사용합니다. | 

## 3단계: Secrets Manager 보안 암호 생성
<a name="kb-managed-confluence-basic-step3"></a>

다음 키-값 페어를 사용하여 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장합니다.

**문서 수준 액세스 제어 없음**

```
{
    "username": "{{your-confluence-email}}",
    "password": "{{your-atlassian-api-token}}",
    "hostUrl": "{{https://your-instance.atlassian.net}}"
}
```

**문서 수준 액세스 제어 사용**

```
{
    "username": "{{your-confluence-email}}",
    "password": "{{your-atlassian-api-token}}",
    "hostUrl": "{{https://your-instance.atlassian.net}}",
    "adminApiKey": "{{your-atlassian-admin-api-key}}",
    "organizationId": "{{your-org-uuid}}",
    "directoryId": "{{your-directory-uuid}}"
}
```

 AWS Command Line Interface다음을 사용하여 보안 암호를 생성합니다.

```
aws secretsmanager create-secret \
  --name {{bedrock-confluence-basic-creds}} \
  --secret-string file://secret.json
```

응답의 보안 암호 ARN을 기록합니다. 이를 데이터 소스 로 사용합니다`secretArn`.

## 다음 단계
<a name="kb-managed-confluence-basic-next"></a>

보안 암호를 저장한 후가 로 `authType` 설정된 데이터 소스를 생성합니다`BASIC`. [Confluence 데이터 소스 연결](kb-managed-ds-confluence-connect.md)을(를) 참조하세요. 사용자 권한별로 쿼리 결과를 필터링하려면 섹션을 참조하세요[문서 수준 액세스 제어](kb-managed-ds-confluence-acl.md).