엔드포인트

IBM Cloudant는 HTTP API 엔드포인트를 통해 액세스됩니다. 인스턴스의 엔드포인트는 인스턴스에 대해 생성되는 서비스 인증 정보의 URL 필드와 다음의 계정 > 설정 둘 다에 표시됩니다. IBM Cloudant 대시보드.

모든 IBM Cloudant HTTP 엔드포인트는 TLS를 통해 액세스되어야 하며 앞에 https://가 와야 합니다.

공용 외부 엔드포인트는 다음 예에 표시되어 있습니다.

https://$ACCOUNT.cloudant.com

2019년 1월 1일 이후 작성된 모든 인스턴스는 appdomain.cloud 도메인 엔드포인트를 포함합니다. 공용 외부 엔드포인트는 다음 예에 표시되어 있습니다.

https://$ACCOUNT.cloudantnosqldb.appdomain.cloud

개인용(내부) 엔드포인트가 Dedicated Hardware 플랜 환경에 배치된 모든 인스턴스에 추가됩니다. 다음 예제에는 IBM Cloud 사설(내부) 네트워크 엔드포인트가 표시되어 있습니다.

https://$ACCOUNT.private.cloudantnosqldb.appdomain.cloud

이전 예시에서, ACCOUNT 는 URL 내 서비스 인스턴스 사용자의 서비스 이름입니다. ACCOUNT 의 예시는 de810d0e-763f-46a6-ae88-50823dc85581-bluemix 이며, 이에 따라 생성되는 외부 엔드포인트의 예시는 de810d0e-763f-46a6-ae88-50823dc85581-bluemix.cloudantnosqldb.appdomain.cloud 입니다.

IP 허용 목록 지정을 사용하여 공용 네트워크 연결을 차단하는 방법에 대한 자세한 정보는 액세스 제어 보안을 참조하십시오.

서비스 인증 정보

IBM Cloud 대시보드를 사용하여 IBM Cloudant에 대한 서비스 인증 정보를 생성하려면, IBM Cloud에서 IBM Cloudant 인스턴스 작성 학습서를 참조하십시오. IBM Cloud CLI에서 서비스 인증 정보를 생성하려면 CLI를 사용하여 인스턴스 작성을 참조하십시오.

다음 예는 IBM Cloudant 인스턴스에 대한 서비스 인증 정보를 보여줍니다.

{
  "apikey": "MxVp86XHkU82Wc97tdvDF8qM8B0Xdit2RqR1mGfVXPWz",
  "host": "76838001-b883-444d-90d0-46f89e942a15-bluemix.cloudant.com",
  "iam_apikey_description": "Auto generated apikey during resource-key [...]",
  "iam_apikey_name": "auto-generated-apikey-050d21b5-5f[...]",
  "iam_role_crn": "crn:v1:bluemix:public:iam::::serviceRole:Manager",
  "iam_serviceid_crn": "crn:v1:staging:public:iam-identity::[...]",
  "password": "8fb6a16b48903e87b769e7f4968521e85c2394ed8f0e69b2769e56dcb27d2e76",
  "port": 443,
  "url": "https://<username>:<password>@76838001-b883-444d-90d0-46f89e942a15-bluemix.cloudant.com",
  "username": "apikey-v2-58B528DF5397465BB6673E1B79482A8C"
}

서비스 인증 정보는 다음 필드를 포함합니다.

username

애플리케이션이 서비스 인스턴스에 액세스하기 위해 필요한 사용자 이름입니다.

password

애플리케이션이 서비스 인스턴스에 액세스하는 데 필요한 레거시 인증 정보 비밀번호입니다. 이 필드는 Use both legacy credentials and IAM 옵션이 선택된 경우에만 표시됩니다.

host

애플리케이션이 서비스 인스턴스를 찾기 위해 사용하는 호스트 이름입니다. 이 필드는 Use both legacy credentials and IAM 옵션이 선택된 경우에만 표시됩니다.

port

호스트의 서비스 인스턴스에 액세스하는 데 필요한 HTTPS 포트 번호입니다. IBM Cloudant는 HTTPS 액세스만 허용하므로 이는 443입니다. 이 필드는 Use both legacy credentials and IAM 옵션이 선택된 경우에만 표시됩니다.

url

IBM Cloudant 인스턴스에 액세스하는 데 필요한 HTTPS URL입니다. Use both legacy credentials and IAM 옵션이 선택된 경우 이는 임베드된 레거시 사용자 이름 및 비밀번호 또한 포함합니다.

apikey

IAM API 키입니다.

iam_apikey_description

IAM API 키에 대한 설명입니다.

iam_apikey_name

IAM API 키의 ID입니다.

iam_role_crn

IAM API 키가 가진 IAM 역할입니다.

iam_serviceid_crn

서비스 ID의 CRN입니다.

인증

{{{site.data.keyword.cloudant_short_notm}} 프로비저닝 시 다음 두 가지 인증 방법을 사용할 수 있습니다 Use only IAM 또는 Use both legacy credentials and IAM. Use both legacy credentials and IAM 인증 방법을 선택한 경우에만 서비스 인증 정보에서 레거시 인증 정보에 대한 세부사항을 볼 수 있습니다. 인증 정보는 인스턴스의 서비스 인증 정보 탭에 표시됩니다. 자세한 내용은 IAM 가이드를 참조하십시오. 사용 방법에 대한 자세한 내용은 기존 인증 문서를 참조하십시오 두 인증 방식 중 하나.

IBM Cloudant 팀에서는 가능한 한 인증에 IAM 액세스 제어를 사용할 것을 권장합니다. IBM Cloudant 의 기존 인증 방식을 사용하는 경우, 프로그래밍 방식의 액세스 및 복제 작업에는 계정 수준의 인증 정보 대신 API 키를 사용해야 합니다.

IBM Cloudant 대시보드

IBM Cloudant 대시보드 인스턴스 세부사항 페이지의 관리 탭으로 이동하여 인스턴스에 대한 IBM Cloud 대시보드를 열 수 있습니다. Launch 또는 Launch Cloudant Dashboard를 사용하여 새 브라우저 탭에서 대시보드를 열 수 있습니다. IBM Cloudant 대시보드를 사용하여 다음 태스크를 수행할 수 있습니다.

• 인스턴스의 현재 이용 모니터
• IBM Cloudant 데이터베이스, 문서 및 인덱스에 대한 작성, 검색, 업데이트 및 삭제 작업을 수행합니다.
• 복제 작업 설정 및 보기
• 활성 태스크 보기
• 프로비저닝되는 처리량 용량, 공지사항, CORS 및 설정과 같은 계정 정보 보기 및 업데이트

프로그래밍 방식 액세스