연결 방법을 선택합니다.
Atlas CLI 에서 기존 Atlas 계정에 연결하는 경우 atlas auth login 명령에 대해 다음 옵션 중 하나를 사용하여 인증할 수 있습니다.
옵션 | 인증 방법 | 사용 사례 |
|---|---|---|
| Atlas 로그인 자격 증명 및 인증 토큰 | 프로그래밍이 아닌 용도에 적합 |
| 서비스 계정 | 서비스 계정과 함께 프로그래밍 방식으로 사용하기에 가장 좋습니다. |
| API 키 | API 키와 함께 프로그래밍 방식으로 사용하는 데 가장 적합합니다. |
중요
이전 Atlas CLI 버전의 1.47 경우, API 키는 Atlas CLI 구성 파일 에 일반 텍스트로 저장됩니다.API 키는 비밀번호와 같습니다. 구성 파일 적절히 보호하고 있는지 확인합니다. Atlas CLI 1.47+ 자격 증명 안전하게 저장 하려고 시도합니다.
새 Atlas 계정을 생성하거나 클러스터가 없는 기존 계정을 온보딩하려면 Atlas 시작하기를 참조하세요.
사용 가능한 연결 옵션에 대해 자세히 알아보려면 아래에서 사용 사례를 선택하세요.
atlas auth login 명령과 옵션을 함께 UserAccount 사용하면 Atlas 로그인 자격 증명 및 일회성 인증 토큰으로 인증할 UserAccount 수 있습니다. 옵션을 사용하려면 수동 로그인 및 인증 토큰 확인이 필요하며, 이 토큰은 12 시간 동안유효합니다. 옵션으로 연결할 때 API 키는 선택 UserAccount 사항입니다.
UserAccount 옵션으로 atlas auth login 를 실행 후에는 다음을 수행할 수 있습니다.
최소한의 필수 설정으로 연결하고 각 명령에
--projectId및--orgId플래그를 지정합니다. 처음 로그인하는 경우 가장 빠르게 시작할 수 있는 방법입니다.연결 설정을 프로필에 저장합니다. 프로필은 프로젝트 ID, 조직 ID, 향후 Atlas CLI 세션에서 사용할 API 키(선택 사항)를 저장합니다. 시간을 절약하기 위해 각 명령에
--projectId및--orgId플래그를 사용하지 않고 대신 프로필을 지정할 수 있습니다.
atlas auth login 명령을 ServiceAccounts 옵션과 함께 실행 Atlas CLI 클라이언트 ID 와 시크릿을 입력하라는 메시지가 표시됩니다. ServiceAccounts 옵션은 MongoDB 리소스를 자동화하고 관리 할 수 있으므로 프로그래밍 방식으로 사용하는 것이 좋습니다. OAuth 애플리케이션이라고도 하는 서비스 계정을 사용하면 지정된 보안 클라이언트 ID 및 시크릿을 통해 프로그래밍 방식으로 액세스 할 수 있습니다. 이 방법은 스크립팅 사용 사례 및 지속적인 통합 또는 전달 워크플로에 적합합니다.
참고
이 프로세스 대화형입니다. 프로그래밍 방식 인증 의 MONGODB_ATLAS_CLIENT_ID MONGODB_ATLAS_CLIENT_SECRET 경우 {atlas-cli+}를 사용하기 전에 및 환경 변수를 설정하다 . 지원되는 모든 환경 변수에 대해 자세히 학습 Atlas CLI 환경 변수를 참조하세요.
이 명령으로 인증하려면 API 키를 구성해야 합니다.
APIKeys 옵션과 함께 atlas auth login 명령을 실행 Atlas CLI API 키를 제공하라는 메시지가 표시되고 API 키를 저장하는 프로필이 자동으로 생성됩니다. APIKeys 옵션은 수동 로그인이나 토큰 확인이 필요하지 않으므로 프로그래밍 방식으로 사용하는 것이 좋습니다.
APIKeys 옵션과 함께 atlas auth login 명령을 사용하여 연결을 사용하면 다음을 수행할 수 있습니다.
최소한의 필수 설정으로 연결하고 각 명령에
--projectId및--orgId플래그를 지정합니다. 처음 로그인하는 경우 가장 빠르게 시작할 수 있는 방법입니다.프로필에 추가 연결 설정을 저장합니다. 프로필은 프로젝트 ID, 조직 ID 및 선택적으로 향후 Atlas CLI 세션에서 사용할 API 키를 저장합니다. 시간을 절약하기 위해 각 명령에
--projectId및--orgId플래그를 사용하는 대신 프로필을 지정할 수 있습니다.
최소 필수 설정으로 연결
사용 사례를 선택하고 단계에 따라 최소 필수 설정으로 Atlas CLI에서 연결합니다.
사전 요구 사항을 완료하세요.
호스트의 IP 주소를 IP 액세스 목록에추가합니다.
Atlas user 자격 증명으로 인증하고 조직의 소유자가 조직의 UI에IP 대한 액세스 Atlas 목록을 IP IP 활성화한 경우, 이 조직에서 명령을 실행하려면 주소를 액세스 목록에 추가해야 합니다. 자세한 내용 은 Atlas UI에 IP 액세스 목록 필요를 참조하세요.
시작하기 전에 다음 사항이 있는지 확인하세요.
활동 중인 Atlas 조직.
서비스 계정이 생성되고 구성되었습니다. 자세히 학습 조직에 프로그래밍 방식 액세스 권한 부여를 참조하세요.
서비스 계정의 클라이언트 ID 및 비밀입니다.
다음 단계를 따르세요.
사용 사례를 선택하고 절차에 따라 Atlas CLI에서 빠르게 연결합니다.
Atlas CLI로 돌아가서 기본 프로필 옵션을 수락합니다.
터미널로 돌아갑니다. 연결에 성공하면 메시지가 표시됩니다.
Successfully logged in as {Your Email Address}.
다음 옵션이 표시되면 Enter 눌러 기본 프로필 구성을 수락합니다.
Default Org IDDefault Project IDDefault Output FormatDefault MongoDB Shell Path
중요
이전에 MongoCLI용 API 키로 프로필을 설정한 적이 있다면 프로필이 자동으로 마이그레이션됩니다. 마이그레이션된 일부 프로필로 인해 atlas auth login으로 인증할 때 Atlas CLI 명령이 실패할 수 있습니다. 충돌이 있는 경우 atlas auth login을 실행하면 다음 메시지가 표시됩니다.
There was an error fetching your organizations: Global user is from outside access listed subnets.
충돌을 해결하려면 구성 파일을 열고 기본 프로필을 제거한 다음 atlas auth login를 다시 실행하십시오.
및 플래그를 사용하여 명령을 --projectId --orgId 실행합니다.
Atlas CLI 세션 중에 Atlas CLI 명령을 실행하는 경우 --projectId 및 --orgId 플래그를 사용하여 프로젝트 ID와 조직 ID를 지정합니다.
예시
atlas alerts list --projectId 60b3c81153cf986293e2608b
및 플래그를 사용하여 명령을 --projectId --orgId 실행합니다.
Atlas CLI 세션 중에 Atlas CLI 명령을 실행하는 경우 --projectId 및 --orgId 플래그를 사용하여 프로젝트 ID와 조직 ID를 지정합니다.
예시
atlas alerts list --projectId 60b3c81153cf986293e2608b
및 플래그를 사용하여 명령을 --projectId --orgId 실행합니다.
Atlas CLI 세션 중에 Atlas CLI 명령을 실행하는 경우 --projectId 및 --orgId 플래그를 사용하여 프로젝트 ID와 조직 ID를 지정합니다.
예시
atlas alerts list --projectId 60b3c81153cf986293e2608b
다음 단계로 넘어갑니다.
Atlas CLI 명령 사용을 시작하세요.
기본 프로필을 수정하여 연결 설정을 저장하거나 다른 프로필을 만들려면 연결 설정 저장을 참조하세요.