POST `/admin/saml/providers`

注册一个新的SAML身份提供商配置

SAML 管理 `bearerAuth` application/json

请求体

Schema： service-saml/internal/handler/dto.SamlProviderRequest

字段	类型	必填	示例	约束	描述
`certificate`	`string`	是	`-----BEGIN CERTIFICATE----- MIID -----END CERTIFICATE-----`
`entity_id`	`string`	是	`https://login.microsoftonline.com/example/saml2`
`name`	`string`	是	`Azure AD`
`sso_url`	`string`	是	`https://login.microsoftonline.com/example/saml2`
`allow_idp_initiated`	`boolean`	否	`False`
`certificate_backup`	`string`	否	`-----BEGIN CERTIFICATE----- MIID -----END CERTIFICATE-----`
`default_redirect_uri`	`string`	否	`https://app.example.com`
`enabled`	`boolean`	否	`True`
`force_authn`	`boolean`	否	`False`
`name_id_format`	`string`	否	`urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress`
`should_clear_backup`	`boolean`	否	`False`
`slo_url`	`string`	否	`https://login.microsoftonline.com/example/saml2/slo`
`want_authn_signed`	`boolean`	否	`True`

响应

状态	描述	Schema
200	OK	`service-saml/internal/handler/dto.SamlProviderItemDetailResponse`

引用的 Schema

service-saml/internal/handler/dto.SamlProviderItem

字段	类型	必填	示例	约束	描述
`allow_idp_initiated`	`boolean`	否	`False`
`certificate_expiry`	`string`	否
`created_at`	`string`	否	`2026-05-31T10:00:00Z`
`default_redirect_uri`	`string`	否	`https://app.example.com`
`enabled`	`boolean`	否	`True`
`entity_id`	`string`	否	`https://login.microsoftonline.com/example/saml2`
`force_authn`	`boolean`	否	`False`
`has_backup_cert`	`boolean`	否	`False`
`id`	`string`	否	`01JNXXXXX...`
`name`	`string`	否	`Azure AD`
`name_id_format`	`string`	否	`urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress`
`slo_url`	`string`	否	`https://login.microsoftonline.com/example/saml2/slo`
`sso_url`	`string`	否	`https://login.microsoftonline.com/example/saml2`
`tenant_id`	`string`	否	`01JNYYYYY...`
`updated_at`	`string`	否	`2026-05-31T10:00:00Z`
`want_authn_signed`	`boolean`	否	`True`

service-saml/internal/handler/dto.SamlProviderItemDetailResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-saml/internal/handler/dto.SamlProviderItem`	否
`message`	`string`	否
`timestamp`	`string`	否

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓