使用 AWS ECS 从 Linux 容器上运行的 .NET Core 应用程序访问具有集成安全性的 SQL Server

Val*_*era 2 .net sql-server amazon-web-services amazon-ecs docker

我有一个使用 AWS ECS Fargate 在 Linux 容器上运行的 .NET Core 应用程序。

如何使用集成安全性从该应用程序连接到 SQL Server?

Val*_*era 5

步骤 1:确保 SQL Server 支持 Kerberos 身份验证 # 使用 SQL Server Management Studio (SSMS),连接到数据库并执行以下语句:

select auth_scheme  
from sys.dm_exec_connections 
where session_id = @@spid
Run Code Online (Sandbox Code Playgroud)

如果查询结果为KERBEROS,则一切就绪并继续执行步骤 2。否则,如果结果为NTLM,则意味着 Kerberos 身份验证失败,并且 SSMS 会默默地回退到使用 NTLM 身份验证。由于 SQL Server 与 Linux 环境中运行的客户端之间的集成安全性完全依赖于 Kerberos 身份验证,因此必须首先解决此问题。

注意:连接到 SQL Server 时,请务必使用服务器主机名或 FQDN 而不是 IP 地址,否则 Kerberos 身份验证将无法工作。

检查 SPN配置

确保为 SQL Server 正确配置 SPN。

Microsoft 还发布了几个可以帮助进行 SPN 验证和配置的诊断工具:

最后但并非最不重要的一点是,您可以使用以下setspn命令来查询特定的 SPN:

setspn -T CONTOSO.COM -F -Q MSSQLSvc/your_sql_server.contoso.com
Run Code Online (Sandbox Code Playgroud)

上面的查询是否支持*通配符(替换CONTOSO.COM为您的域名)

配置Kerberos 允许的加密类型

在 Active Directory 中,找到运行 SQL Server 的帐户。在“帐户”选项卡和“帐户选项”部分下,确认已选择适用的 Kerberos 密码

例子:

在此输入图像描述

步骤 2:配置 ECS 任务 要使用 Kerberos 身份验证,ECS 服务内的应用程序任务将由两个容器组成:

  1. 将使用命令定期(重新)获取和缓存 Kerberos 票证授予票证 (TGT) 的容器kinit
  2. 一个容器,它将运行应用程序,并使用第一个任务获取的 TGT 对 MS SQL Server 进行身份验证。

两个容器将安装相同的卷。第一个容器将缓存/写入 TGT 票证,第二个容器将从其中读取缓存的 TGT 票证。

TGT采集容器(sidecar容器)

设置 TGT 获取容器只需要 3 个文件:

  1. krb5.conf - Kerberos 配置文件。
  2. renew.sh - 包含更新 TGT 命令的脚本文件。
  3. Dockerfile - 将所有内容打包到 Docker 镜像中。
# krb5.conf
[libdefaults]
dns_lookup_realm = true
dns_lookup_kdc = true
forwardable = true
default_ccache_name = FILE:/var/kerberos/krbcache # TGT cache location
default_realm = CONTOSO.COM
permitted_enctypes = aes256-cts aes128-cts

[realms]
CONTOSO.COM = {
  kdc = CONTOSO.COM
  admin_server = CONTOSO.COM
}

[domain_realm]
.contoso.com = SCIF.COM
contoso.com = SCIF.COM

[logging]
default = STDERR
Run Code Online (Sandbox Code Playgroud)
# renew.sh
#!/bin/bash

# Refresh the token periodically.
# Set the length of time that the script will wait to refresh the token.
[[ "$DELAY_SECONDS" == "" ]] && DELAY_SECONDS=3600

# If the AWS region hasn't been set, get it from instance metadata. This will work in an instance as well as in an ECS container.
[[ "$AWS_REGION" == "" ]] && AWS_REGION=$(curl --silent http://169.254.169.254/latest/dynamic/instance-identity/document | jq -r .region)

# Use the ECS container as the source for AWS credentials. This allows the AWS CLI to use the permissions of the task role.
aws configure set credential_source EcsContainer


while true
do
    echo "Starting ticket renewal at: " + $(date)

    # Get the credentials from Secrets Manager.
    CREDENTIALS_SECRET_VALUE=$(aws secretsmanager get-secret-value --secret-id $CREDENTIALS_SECRET_ARN --region $AWS_REGION --query SecretString --output text)

    # Use `jq` to parse the credentials into username & password.
    CREDENTIALS_USERNAME=$(echo $CREDENTIALS_SECRET_VALUE | jq -r '.username')
    CREDENTIALS_PASSWORD=$(echo $CREDENTIALS_SECRET_VALUE | jq -r '.password')

    # Use the username & password to authenticate to Kerberos. The resulting token is written to the token cache, 
    # which is set up in `krb5.conf` to use the task scratch volume, shared by all containers.
    echo $CREDENTIALS_PASSWORD | kinit $CREDENTIALS_USERNAME -f -V $OPTIONS

    echo "Ticket renewal complete, waiting for $DELAY_SECONDS seconds"


    sleep $DELAY_SECONDS &
    wait
done
Run Code Online (Sandbox Code Playgroud)
# Dockerfile

FROM amazonlinux:2

COPY renew.sh /
COPY krb5.conf /etc/krb5.conf

# Install the Kerberos tools -- to authenticate;
# `jq` -- to parse the credentials from the AWS Secrets Manager, which returns JSON
# `unzip` -- to install the latest version of the AWS CLI
RUN yum install -y krb5-workstation jq unzip 

# Download and install the latest version of the AWS CLI
RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
RUN unzip awscliv2.zip
RUN ./aws/install

VOLUME ["/var/kerberos"]

ENTRYPOINT ["/renew.sh"]
Run Code Online (Sandbox Code Playgroud)

根据 中指定的值CREDENTIALS_SECRET_ARN,renew.sh 将定期更新 TGT 并将其缓存/保存在 krb5.conf 文件指定的位置(例如/var/kerberos/krbcache)。

要测试容器是否成功获取给定原则的 TGT,请与容器建立交互会话并执行klist命令。成功后,您应该看到 TGT 票证的详细信息,包括主体名称、到期日期等。

应用容器

应用程序容器运行您的 .NET Core 应用程序。要在该容器上启用 Kerberos,请在 Dockerfile 中添加以下行:

...
RUN apt update
RUN apt install -y krb5-config krb5-user  
COPY krb5.conf /etc/krb5.conf
VOLUME ["/var/kerberos"]
...
Run Code Online (Sandbox Code Playgroud)

krb5.conf 文件的内容应与 TGT 获取容器中的内容相同,它将指示应用程序在 处定位 Kerberos TGT FILE:/var/kerberos/krbcache

您的应用程序 SQL 连接字符串应类似于以下内容:

Server=yourSqlServer.contoso.com;Initial Catalog=YourDB;Integrated Security=true;
Run Code Online (Sandbox Code Playgroud)

要测试容器是否有权访问缓存的 TGT,请与容器建立交互式会话并执行klist. 成功后,您应该看到与另一个容器中相同的 TGT 票证。

如果一切顺利,您应该能够使用集成安全性从 Linux 上运行的 .NET Core 应用程序成功连接到 SQL Server。

其他资源