You need to enable JavaScript to run this app. 如何通过Terraform在Azure AD实现非库SAML企业应用的SSO配置?
优惠活动
大模型
产品
解决方案
定价
更多

如何通过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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 21:06:03