如何通过Terraform在Azure AD实现非库SAML企业应用的SSO配置?
Terraform 实现 Azure AD 非画廊 SAML 企业应用接入
原有配置的局限性
你之前编写的配置仅基于azuread_application资源实现,这类资源只会在Azure AD的「应用注册」分类下创建独立对象,不会自动生成「企业应用」分类下对应的服务主体实例,更无法承载SAML SSO相关的协议参数配置——这就是配置执行后只能看到应用注册对象、完全没有SSO配置项的根本原因。
实现非画廊SAML应用接入的资源逻辑
Azure AD侧的SAML企业应用接入是多实体关联的完整流程,无法靠单个资源完成,需要按照对象的依赖关系组合三类核心配置:
- 创建SAML应用对应的应用注册对象,定义应用的基础身份属性,包括应用ID、回调地址、SAML受众标识等基础信息
- 基于应用注册创建关联的企业服务主体,也就是Azure AD「企业应用」列表中可见的实际接入对象;非画廊类应用不需要绑定微软Gallery应用模板,可直接基于自有应用注册创建独立服务主体
- 在服务主体层面配置SAML SSO的全量参数,包括签署证书、中继状态、响应格式等和SSO直接相关的配置项
可参考的Terraform实现脚本
# 生成SAML签署所需的私钥与自签名证书 resource "tls_private_key" "saml_sign_key" { algorithm = "RSA" rsa_bits = 4096 } resource "tls_self_signed_cert" "saml_sign_cert" { private_key_pem = tls_private_key.saml_sign_key.private_key_pem dns_names = ["example.com"] valid_period_hours = 87600 # 证书有效期10年 allowed_uses = [ "key_encipherment", "digital_signature" ] } # 创建SAML应用对应的应用注册 resource "azuread_application" "test_saml_app" { display_name = "Test_App" homepage = "http://example.com/" identifier_uris = ["https://example.com/saml"] sign_in_audience = "AzureADMyOrg" web { redirect_uris = ["https://example.com/saml"] } } # 为应用注册创建关联的企业服务主体(非画廊应用对象) resource "azuread_service_principal" "test_saml_sp" { application_id = azuread_application.test_saml_app.application_id account_enabled = true use_existing = false # 跳过画廊模板匹配,创建独立非画廊服务主体 saml_single_sign_on { relay_state = "target-app-path" } preferred_token_signing_key_thumbprint = azuread_application_certificate.saml_cert.thumbprint } # 为应用配置SAML响应签署证书 resource "azuread_application_certificate" "saml_cert" { application_id = azuread_application.test_saml_app.id type = "asymmetricx509" encoding = "pem" start_date = tls_self_signed_cert.saml_sign_cert.validity_start_time end_date = tls_self_signed_cert.saml_sign_cert.validity_end_time value = tls_self_signed_cert.saml_sign_cert.cert_pem }
配置生效说明
完成上述配置后,即可在Azure AD的企业应用列表中看到新建的非画廊SAML应用,自动实现以下能力:
- 生成标准SAML协议对接所需的实体ID、登录地址、回调地址配置
- 自动配置SAML响应签署的证书信息,可直接导出元数据给目标SAML应用完成对接
- 所有配置项可通过Terraform持续纳管,无需在Azure Portal手动操作SSO配置流程
核心注意点:所有和企业应用SAML相关的配置,都需要挂载在
azuread_service_principal资源上,而不是应用注册资源上——这也是最初的配置只能生成应用注册对象、无法落地SSO配置的核心差异。
内容的提问来源于stack exchange,提问作者Subhajit Dey
相关产品推荐
相关产品推荐

