要查找 entity_id
,请使用 SAML 实体详细信息端点。
使用此端点更新 SAML 实体设置。
curl -X PUT \
'https://www.digicert.com/services/v2/account/saml-entity/{{saml_id}}' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
"source_url": "{{idp_metadata_url}}",
"attribute_mapping": "{\"username\":\"NameID\"}",
"friendly_name": "Your Company, Inc."
}'
import requests
url = "https://www.digicert.com/services/v2/account/saml-entity/{{saml_id}}"
payload = "{\n \"source_url\": \"{{idp_metadata_url}}\",\n \"attribute_mapping\": \"{\\\"username\\\":\\\"NameID\\\"}\",\n \"friendly_name\": \"Your Company, Inc.\"\n}"
headers = {
'X-DC-DEVKEY': "{{api_key}}",
'Content-Type': "application/json"
}
response = requests.request("PUT", url, data=payload, headers=headers)
print(response.text)
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://www.digicert.com/services/v2/account/saml-entity/{{saml_id}}"
payload := strings.NewReader("{\n \"source_url\": \"{{idp_metadata_url}}\",\n \"attribute_mapping\": \"{\\\"username\\\":\\\"NameID\\\"}\",\n \"friendly_name\": \"Your Company, Inc.\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
var request = require("request");
var options = { method: 'PUT',
url: 'https://www.digicert.com/services/v2/account/saml-entity/{{saml_id}}',
headers:
{ 'Content-Type': 'application/json',
'X-DC-DEVKEY': '{{api_key}}' },
body:
{ source_url: '{{idp_metadata_url}}',
attribute_mapping: '{"username":"NameID"}',
friendly_name: 'Your Company, Inc.' },
json: true };
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
// empty
返回 friendly_name_in_use
错误的条件是当 friendly_name
值已经在使用时。
名称 | 请求/选项 | 类型 | 描述 |
---|---|---|---|
xml_metadata | 必填* | string |
SAML 实体 XML 元数据。 *仅当未使用 source_url 时必填
|
source_url | 必填* | string |
用于获取 SAML 实体 XML 元数据的 URL。 *仅当未使用 xml_metadata 时必填
|
attribute_mapping | 必填 | 字符串 |
用于将 CertCentral 用户映射到 SAML SSO 用户的属性。 格式: {"用户名": "{{attr_name}}"}
|
friendly_name | 必填 | string | 显示用于联盟名称以及为 SSO 登录 URL 生成 slug 的名称。 |