选择连接方法
当您从Atlas CLI连接到现有Atlas帐户时，可以使用 atlas auth login 命令的以下选项之一进行身份验证：
选项 | 身份验证方法 | 用例(Use Case) |
|---|---|---|
| Atlas 登录凭证和身份验证令牌 | 最适合非编程使用 |
| 服务帐户 | 最适合通过服务帐号以编程方式使用 |
| API 密钥 | 最适合通过API密钥以编程方式使用 |
重要
对于 之前的Atlas CLI版本，1.47 API密钥以明文形式存储在Atlas CLI配置文件中。 API密钥就像密码一样。确保以适当方式保护配置文件。 Atlas CLI1.47 + 尝试安全地存储凭证。
要创建新的 Atlas 帐户或启用没有任何集群的现有帐户，请参阅开始使用 Atlas。
选择下方的使用案例，以了解有关可用连接选项的更多信息：
使用带有atlas auth login 选项的UserAccount 命令，使用您的Atlas登录凭证和一次性身份身份验证令牌进行身份验证。UserAccount 选项需要手动登录并验证身份验证令牌，该令牌的有效期为12 小时。使用 选项连接时，UserAccount API密钥是可选的。
使用 UserAccount 选项运行atlas auth login 后，您可以：
按照最低设置要求进行连接，并在每个命令中指定
--projectId和--orgId标志。这是首次登录的最快开始方式。将连接设置保存在配置文件中。配置文件存储项目 ID 和组织 ID，以及可选的 API 密钥，以便在将来的 Atlas CLI 会话中使用。为了节省时间，您可以指定配置文件，而不是在每个命令中使用
--projectId和--orgId标志。
当您运行带有 ServiceAccounts 选项的 atlas auth login 命令时， Atlas CLI会提示您提供客户端ID和密钥。 ServiceAccounts 选项非常适合编程使用，因为它允许您自动执行和管理MongoDB资源。服务帐户（也称为 OAuth 应用程序）允许通过指定的安全客户端ID和密钥进行编程访问权限。此方法非常适合编写用例脚本和持续集成或交付工作流程。
注意
这个进程是交互式的。对于编程身份验证，请在使用MONGODB_ATLAS_CLIENT_ID MONGODB_ATLAS_CLIENT_SECRET{atlas-cli+} 之前设立 和 环境变量。要学习；了解有关所有支持的环境变量的更多信息，请参阅Atlas CLI环境变量。
您必须配置 API 密钥才能使用此命令进行身份验证。
当您使用atlas auth login 选项运行APIKeys 命令时， Atlas CLI会提示您提供API密钥，并自动创建一个存储API密钥的配置文件。 APIKeys选项非常适合编程使用，因为它不需要手动登录或令牌验证。
使用带有 APIKeys 选项的 atlas auth login 命令进行连接时，您可以：
按照最低设置要求进行连接，并在每个命令中指定
--projectId和--orgId标志。这是首次登录的最快开始方式。将其他连接设置保存在配置文件中。配置文件存储项目 ID 和组织 ID，以及可选的 API 密钥，以便在将来的 Atlas CLI 会话中使用。为了节省时间，您可以指定配置文件，而不是在每个命令中使用
--projectId和--orgId标志。
使用最少必要设置进行连接
选择一个使用案例，按照步骤以所需的最低设置从 Atlas CLI 进行连接。
满足先决条件
将您主机的 IP 地址添加到 IP 访问列表中。
如果您使用Atlas user IP档案进行身份验证，并且组织所有者为组织启用 了 用户界面的 访问列表，则Atlas IP必须将您的 地址添加到IP 访问列表才能运行该组织中的命令。要了解更多信息，请参阅Atlas 用户界面需要 IP 访问列表。
在开始之前，请确保您拥有：
一个活跃的Atlas组织。
服务帐户的客户端ID和密钥。
按照以下步骤操作
选择一个使用案例并按照步骤从 Atlas CLI 进行快速连接。
使用--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 命令。
要通过修改默认配置文件或创建不同的配置文件来保存连接设置，请参阅保存连接设置。