Um die entity_id
zu finden,, verwenden Sie den Endpunkt SAML-Entitätsdetails.
Verwenden Sie diesen Endpunkt, um SAML-Entitätseinstellungen zu aktualisieren.
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
Falls der gesendete friendly_name
-Wert bereits verwendet wird, wird ein friendly_name_in_use
-Fehler zurückgegeben.
Name | Antr./Opt. | Typ | Beschreibung |
---|---|---|---|
xml_metadata | erforderlich* | string |
XML-Metadaten der SAML-Entität * Nur erforderlich, falls die source_url nicht verwendet wird
|
source_url | erforderlich* | string |
URL, die verwendet wird, um die XML-Metadaten der SAML-Entität zu erhalten * Nur erforderlich, falls die xml_metadata nicht verwendet wird
|
attribute_mapping | erforderlich | Zeichenfolge |
Attribut, mit dem CertCentral-Benutzer SAML-SSO-Benutzern zugeordnet werden Format: {"Benutzername": "{{attr_name}}"}
|
friendly_name | erforderlich | string | Anzeigename, der für den Verbundnamen verwendet wird sowie für die Generierung der Kurzversion für die SSO-Anmelde-URL. |