认证 DC/OS 服务

ENTERPRISE

为自定义应用程序和 pod 配置身份认证

本主题详细介绍了如何为在 DC/OS 上启动的自定义应用程序和 Pod 配置身份认证。

前提条件:

创建密钥对

使用 DC/OS Enterprise CLI 创建 2048 位 RSA 公私密钥对。将每个值保存到当前目录中的单独文件中。

  1. dcos security org service-accounts keypair <private-key>.pem <public-key>.pem

使用 DC/OS 密钥存储库 保护钥匙对。

创建服务帐户

您可以使用 DC/OS Enterprise CLI 或 DC/OS Web 界面创建服务帐户。

使用 DC/OS Enterprise CLI

从终端提示创建包含包含公钥 (<your-public-key>.pem) 的新服务帐户 (<service-account-id>)。

  1. dcos security org service-accounts create -p <your-public-key>.pem -d "<description>" <service-account-id>

使用以下命令验证您的新服务帐户。

  1. dcos security org service-accounts show <service-account-id>

使用 Web 界面

  1. 在 DC/OS Web 界面,导航至 Organization -> Service Accounts 选项卡。

  2. 单击右上方的 + 图标。

    单击服务帐户创建按钮

    图 1. 单击服务帐户创建按钮

  3. 输入描述并在 ID 字段中输入服务帐户 ID。

  4. 将与帐户相关联的公钥粘贴到 PUBLIC KEY 字段中。

    创建服务帐户 UI

    图 2. 创建新服务帐户

创建密钥

使用您的服务帐户 (service-account-id>) 和指定的私钥 (<private-key>.pem) 创建密码。

宽容

  1. dcos security secrets create-sa-secret <private-key>.pem <service-account-id> <secret-name>

严格

在严格模式下,服务帐户名称 (<service-account-id>) 必须与框架 principal 中指定的名称相匹配。

  1. dcos security secrets create-sa-secret --strict <private-key>.pem <service-account-id> <secret-name>

使用此命令列出密钥:

  1. dcos security secrets list /

创建和分配权限

确定所需权限

使用此程序确定服务帐户所需的访问权限。这将允许您排除可能由错误权限导致的任何功能问题。

  1. SSH 到您的节点

    1. dcos node ssh --master-proxy --mesos-id=<mesos-id>
  2. 运行此 grep 命令以查看服务帐户 (<service-account-id>) 的 deny 日志。

    1. journalctl -u "dcos-*" |grep "audit" |grep "<service-account-id>" |grep "deny"

    此命令将返回由于权限不足或令牌不良而拒绝访问服务时生成的审核日志列表。拒绝消息应包括缺失的权限。您可能需要多次重复此过程,以确定所需权限的完整列表。

故障排除

您可以授予服务超级用户权限以排除任何功能问题。所有有效的服务都应该能够以超级用户身份运行。

  1. curl -x put --cacert dcos-ca.crt \
  2. -h "authorization: token=$(dcos config show core.dcos_acs_token)" $(dcos config show core.dcos_url)/acs/api/v1/acls/dcos:superuser/users/<service-account-id>/full

如需更多信息,请参阅 权限参考

分配权限

使用 权限参考 和日志输出,为您的服务分配权限。所有 CLI 命令也可通过 IAM API 执行。

使用 CLI

您可以使用 CLI 分配权限。例如,为将在 DC/OS 上卸载的 Cassandra 服务授权:

授予权限 (dcos:mesos:master:framework:role:cassandra-role) 和允许的操作 (create)。

  1. dcos security org users grant <service-account-id> dcos:mesos:master:framework:role:cassandra-role create --description "Controls the ability of cassandra-role to register as a framework with the Mesos master"

使用 Web 界面

  1. 以具有超级用户权限的用户身份登录 DC/OS Web 界面。

  2. 选择 Organization > Service Accounts

  3. 选择要授予权限的服务账户名称。

    选择服务帐户

    图 3. 选择服务帐户

  4. 权限选项卡上,单击添加权限

  5. 单击插入权限字符串以切换对话框。

  6. 权限字符串字段中复制并粘贴权限。

    服务帐户权限字符串

    图 4. 服务帐户权限字符串

请求认证令牌

生成 服务登录令牌,其中指定了服务帐户(<service-account-id>)和私钥(<private-key>.pem)。

  1. dcos auth login --username=<service-account-id> --private-key=<private-key>.pem

在后续请求中传递认证令牌

服务成功登录后,将创建一个认证令牌。认证令牌应在后续对 DC/OS 端点的请求中使用。您可以将认证令牌引用为 shell 变量,例如:

  1. curl -H "Authorization: token=$(dcos config show core.dcos_acs_token)"

刷新认证令牌

默认情况下,认证令牌在五天后过期。您的服务将需要在到期之前或之后续订其令牌。令牌本身包含到期时间,因此您的服务可以使用此信息主动刷新令牌。或者,您可以等待从 DC/OS 获取 401,然后刷新。

若要刷新认证令牌,只需重复 请求认证令牌 中讨论的过程。

DC/OS 本机服务帐户

DC/OS 本机服务帐户的凭据是 DC/OS 专用账户,不得由第三方软件(例如,临时脚本)使用。

背景:在 DC/OS 升级程序中,授予 DC/OS 本机服务帐户的权限可能会发生变化。也就是说,在 DC/OS 升级期间,除 DC/OS 本机服务以外的消费者可能遭到中断。值得注意的是,第三方软件不得改变与 DC/OS 本机服务帐户相关的权限(可以在任何时间点恢复此类变动)。

dcos_marathondcos_metronome 服务帐户是例外,它将保留已修改的权限,因为在 strict 安全模式下,DC/OS Enterprise 的某些用户授予 dcos_marathondcos_metronome 权限,以便这些服务可以运行除 nobody 以外的 Unix 用户的任务。