Skip to main content
Element Software
12.5 and 12.7

UpdateIdpConfiguration

Contributors netapp-pcarriga

You can use the UpdateIdpConfiguration method to update an existing configuration with a third-party IdP for the cluster.

Parameters

This method has the following input parameters:

Name Description Type Default value Required

generateNewCertificate

When specified as true, a new SAML key and certificate is generated and replaces the existing pair. Note: Replacing the existing certificate will disrupt the established trust between the cluster and the IdP until the cluster's Service Provider metadata is reloaded at the IdP. If not provided or set to false, the SAML certificate and key remains unchanged.

boolean

None

No

idpConfigurationID

UUID for the third-party IdP configuration.

UUID

None

No

idpMetadata

IdP metadata for configuration and integration details for SAML 2.0 single sign-on.

string

None

No

idpName

Name used to identify and retrieve an IdP provider for SAML 2.0 single sign-on.

string

None

No

newIdpName

If specified, this name replaces the old IdP name.

string

None

No

Return values

This method has the following return value:

Name

Description

Type

idpConfigInfo

Information around the third-party IdP configuration.

Request example

Requests for this method are similar to the following example:

{
"method": "UpdateIdpConfiguration",
"params": {
        "idpConfigurationID": "f983c602-12f9-4c67-b214-bf505185cfed",
        "generateNewCertificate": true
    }
}

Response example

This method returns a response similar to the following example:

{
    "result": {
        "idpConfigInfo": {
        "enabled": true,
        "idpConfigurationID": "f983c602-12f9-4c67-b214-bf505185cfed",
        "idpMetadata": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n
        <EntityDescriptor xmlns=\"urn:oasis:names:tc:SAML:2.0:metadata\"\r\n
        xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\"\r\n
        xmlns:shibmd=\"urn:mace:shibboleth:metadata:1.0\"\r\n
        xmlns:xml=\"http://www.w3.org/XML/1998/namespace\"\r\n
        ...</Organization>\r\n
        </EntityDescriptor>",
        "idpName": "https://privider.name.url.com",
        "serviceProviderCertificate": "-----BEGIN CERTIFICATE-----\n
        MI...BHi\n
        -----END CERTIFICATE-----\n",
        "spMetadataUrl": "https://10.193.100.100/auth/ui/saml2"
        }
    }
}

New since version

12.0