我有一个使用 AWS ECS Fargate 在 Linux 容器上运行的 .NET Core 应用程序。
如何使用集成安全性从该应用程序连接到 SQL Server?
第 1 步:确保 SQL Server 支持 Kerberos 身份验证 # 使用 SQL Server Management Studio (SSMS),连接到您的数据库并执行以下语句:
select auth_scheme
from sys.dm_exec_connections
where session_id = @@spid
如果查询结果为
KERBEROS
,则全部设置完毕并继续执行步骤 2。否则,如果结果为 NTLM
,则意味着 Kerberos 身份验证失败,SSMS 会默默地回退到使用 NTLM 身份验证。由于 SQL Server 和 Linux 环境中运行的客户端之间的集成安全性完全依赖于 Kerberos 身份验证,因此必须首先解决此问题。
注意:连接到 SQL Server 时,请务必使用服务器主机名或 FQDN 而不是 IP 地址,否则 Kerberos 身份验证将无法工作。
检查 SPN 配置
Microsoft 还发布了多种可以帮助进行 SPN 验证和配置的诊断工具:
最后但并非最不重要的一点是,您可以使用以下
setspn
命令来查询特定的 SPN:
setspn -T CONTOSO.COM -F -Q MSSQLSvc/your_sql_server.contoso.com
上面的查询确实支持
*
作为通配符(将 CONTOSO.COM
替换为您的域名)
配置 Kerberos 允许的加密类型
在 Active Directory 中,找到运行 SQL Server 的帐户。在帐户选项卡和帐户选项部分下,确认已选择适用的 Kerberos 密码。
示例:
第2步:配置ECS任务 要使用 Kerberos 身份验证,ECS 服务中的应用程序任务将由两个容器组成:
kinit
命令定期(重新)获取和缓存 Kerberos 票证授予票证 (TGT) 的容器。两个容器将安装相同的卷。第一个容器将缓存/写入 TGT 票证,第二个容器将从其中读取缓存的 TGT 票证。
TGT获取容器(sidecar容器)
设置TGT采集容器只需要3个文件:
# 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 = CONTOSO.COM
contoso.com = CONTOSO.COM
[logging]
default = STDERR
# 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
# 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"]
根据
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"]
...
krb5.conf 文件的内容应与 TGT 获取容器中的内容相同,它将指示应用程序在
FILE:/var/kerberos/krbcache
处定位 Kerberos TGT。
您的应用程序 SQL 连接字符串应类似于以下内容:
Server=yourSqlServer.contoso.com;Initial Catalog=YourDB;Integrated Security=true;
要测试容器是否有权访问缓存的 TGT,请与容器建立交互会话并执行
klist
。成功后,您应该看到与另一个容器中相同的 TGT 票证。
如果一切顺利,您应该能够使用集成安全性从 Linux 上运行的 .NET Core 应用程序成功连接到 SQL Server。
其他资源