Read SAML Metadata Now
Read a SAML IdP's metadata URL now, for example after the IdP published a new signing certificate. ngris also reads it every day. At most once a minute per IdP. A read that fails keeps the last values working and is shown on the IdP (metadata_error). Metadata that was pasted doesn't update itself: send the new one with Update SAML IdP. In the dashboard: Read now on the IdP's row.
Needs the endpoint_saml feature on the plan of the account that owns the endpoint (Enterprise) and the endpoints:update permission. No request body.
Path parameters
uuid from /endpoints.uuid from List SAML IdPs.An integer id in the path is refused with 400 integer_id_unsupported (see public IDs). Use the uuid.
Response (200 OK)
The IdP, as Get SAML IdP answers it, with the new metadata_read_at. When the certificates changed, certs_changed_at says so.
Errors
endpoints:update permission, or the plan doesn't include SAML single sign-on ("entitlement_required": "endpoint_saml").SAML IdP not found).This IdP's metadata was pasted: it doesn't update itself. Paste the new metadata with PUT, or give its URL.); the metadata now names another IdP (The metadata now names another IdP (…). Check it, and add that IdP as a new one if it's right.); the endpoint has no address yet, or it is paused.The metadata was read less than a minute ago. Try again in a minute.SAML single sign-on isn't available yet. Try again in a few minutes.