연결 방법을 선택합니다.
Atlas CLI 에서 기존 Atlas 계정에 연결하는 경우 atlas auth login 명령에 대해 다음 옵션 중 하나를 사용하여 인증할 수 있습니다.
옵션 | 인증 방법 | 사용 사례 |
|---|---|---|
| Atlas 로그인 자격 증명 및 인증 토큰 | 프로그래밍이 아닌 용도에 적합 |
| 서비스 계정 | 서비스 계정과 함께 프로그래밍 방식으로 사용하기에 가장 좋습니다. |
| API 키 | API 키와 함께 프로그래밍 방식으로 사용하는 데 가장 적합합니다. |
중요
1.47 이전 Atlas CLI 버전의 경우, API 키들은 Atlas CLI 설정 파일에 일반 텍스트로 저장됩니다. 당신의 API 키는 비밀번호와 같습니다. 설정 파일을 적절히 보호하고 있는지 확인하십시오. Atlas CLI는 자격 증명을 안전하게 저장하려는 1.47+ 시도를 했습니다.
새 Atlas 계정을 생성하거나 cluster가 없는 기존 계정을 온보딩하려면 Get Started with Atlas 참조합니다.
사용 가능한 연결 옵션에 대해 자세히 알아보려면 아래에서 사용 사례를 선택하세요.
atlas auth login 명령을 ` UserAccount ` 옵션과 함께 사용하여 Atlas 로그인 자격 증명과 일회성 인증 토큰으로 인증합니다. UserAccount 옵션 사용 시에는 수동 로그인 및 인증 토큰 확인이 필요하며, 인증 토큰은 12 시간 동안 유효합니다. UserAccount 옵션 연결 시 API 키는 선택 사항입니다.
UserAccount 옵션으로 atlas auth login 를 실행 후에는 다음을 수행할 수 있습니다.
Connect with minimum required settings and specify the
--projectIdand--orgIdflags with each command. This is the quickest way to get started for first-time login.
atlas auth login 명령을 ServiceAccounts 옵션과 함께 실행 Atlas CLI 클라이언트 ID 와 시크릿을 입력하라는 메시지가 표시됩니다. ServiceAccounts 옵션은 MongoDB 리소스를 자동화하고 관리할 수 있으므로 프로그래밍 방식으로 사용하는 것이 좋습니다. OAuth 애플리케이션이라고도 하는 서비스 계정을 사용하면 지정된 보안 클라이언트 ID 및 시크릿을 통해 프로그래밍 방식으로 액세스할 수 있습니다. 이 방법은 스크립팅 사용 사례 및 지속적인 통합 또는 전달 워크플로에 적합합니다.
참고
이 프로세스 는 대화형입니다. 프로그래밍 방식 인증 의 경우 {atlas-cli+}를 사용하기 전에 MONGODB_ATLAS_CLIENT_ID 및 MONGODB_ATLAS_CLIENT_SECRET 환경 변수를 설정하다 . 지원되는 모든 환경 변수에 대해 자세히 학습하려면 Atlas CLI 환경 변수를 참조하세요.
이 명령으로 인증하려면 API 키를 구성해야 합니다.
atlas auth login 명령을 APIKeys 옵션과 함께 실행하면 Atlas CLI에서 API 키를 제공하라는 메시지를 표시하고 API 키를 저장하는 프로필을 자동으로 생성합니다. APIKeys 옵션은 수동 로그인이나 토큰 검증이 필요하지 않아 프로그래밍적 사용에 적합합니다.
APIKeys 옵션과 함께 atlas auth login 명령을 사용하여 연결을 사용하면 다음을 수행할 수 있습니다.
Connect with minimum required settings and specify the
--projectIdand--orgIdflags with each command. This is the quickest way to get started for first-time login.
최소 필수 설정으로 연결
사용 사례를 선택하고 단계에 따라 최소 필수 설정으로 Atlas CLI에서 연결합니다.
사전 요구 사항을 완료하세요.
Add your host's IP address to the IP access list.
If you authenticate with your Atlas user credentials and your organization's owners enable IP access list for the Atlas UI for an organization, your IP address must be added to the IP access list to run commands in this organization. To learn more, see Require IP Access List for the Atlas UI.
시작하기 전에 다음 사항이 있는지 확인하세요.
Atlas CLI설치되었습니다.
활동 중인 Atlas 조직.
A Service Account created and configured. To learn more, see Grant Programmatic Access to an Organization.
서비스 계정의 클라이언트 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 명령 사용을 시작하세요.
기본 프로필을 수정하여 연결 설정을 저장하거나 다른 프로필을 만들려면 연결 설정 저장을 참조하세요.