Usare Crea un provider SAML con un AWS SDK o CLI

I seguenti esempi di codice mostrano come usare CreateSAMLProvider.

CLI

AWS CLI

Come creare un provider SAML

Quanto segue create-saml-provider l'esempio crea un nuovo provider SAML in IAM denominato MySAMLProvider. È descritto dal documento di metadati SAML che si trova nel file SAMLMetaData.xml.

aws iam create-saml-provider \
    --saml-metadata-document file://SAMLMetaData.xml \
    --name MySAMLProvider

Contenuto di SAMLMetaData.xml:

<?xml version="1.0" encoding="UTF-8"?>
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://idp.example.com/saml/metadata">
    <md:IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
        <md:KeyDescriptor use="signing">
            <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
                <ds:X509Data>
                    <ds:X509Certificate>MIIC8DCCAdigAwIBAgIQEXAMPLE...</ds:X509Certificate>
                </ds:X509Data>
            </ds:KeyInfo>
        </md:KeyDescriptor>
        <md:NameIDFormat>urn:oasis:names:tc:SAML:2.0:nameid-format:persistent</md:NameIDFormat>
        <md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://idp.example.com/saml/sso"/>
    </md:IDPSSODescriptor>
</md:EntityDescriptor>

Output:

{
    "SAMLProviderArn": "arn:aws:iam::123456789012:saml-provider/MySAMLProvider"
}

Per ulteriori informazioni, consulta Creazione di provider di identità SAML IAM nella Guida per l’utente di IAM AWS .

• Per informazioni dettagliate sull’API, consulta CreateSAMLProvider nella documentazione di riferimento dei comandi della AWS CLI .

JavaScript

SDK per JavaScript (v3)

Nota

C'è dell'altro GitHub. Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel repository di esempi di codice AWS.

import { CreateSAMLProviderCommand, IAMClient } from "@aws-sdk/client-iam";
import { readFileSync } from "node:fs";
import * as path from "node:path";
import { dirnameFromMetaUrl } from "@aws-doc-sdk-examples/lib/utils/util-fs.js";

const client = new IAMClient({});

/**
 * This sample document was generated using Auth0.
 * For more information on generating this document, see https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_saml.html#samlstep1.
 */
const sampleMetadataDocument = readFileSync(
  path.join(
    dirnameFromMetaUrl(import.meta.url),
    "../../../../resources/sample_files/sample_saml_metadata.xml",
  ),
);

/**
 *
 * @param {*} providerName
 * @returns
 */
export const createSAMLProvider = async (providerName) => {
  const command = new CreateSAMLProviderCommand({
    Name: providerName,
    SAMLMetadataDocument: sampleMetadataDocument.toString(),
  });

  const response = await client.send(command);
  console.log(response);
  return response;
};

• Per informazioni dettagliate sull’API, consulta CreateSAMLProvider nella documentazione di riferimento dell’API AWS SDK per JavaScript .

PowerShell

Strumenti per PowerShell V4

Esempio 1: questo esempio crea una nuova entità per il provider SAML in IAM. È denominato MySAMLProvider ed è descritto dal documento di metadati SAML contenuto nel file SAMLMetaData.xml, che è stato scaricato separatamente dal sito web del provider di servizi SAML.

New-IAMSAMLProvider -Name MySAMLProvider -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)

Output:

arn:aws:iam::123456789012:saml-provider/MySAMLProvider

• Per informazioni dettagliate sull’API, consulta CreateSAMLProvider nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V4).

Utensili per PowerShell V5

Esempio 1: questo esempio crea una nuova entità per il provider SAML in IAM. È denominato MySAMLProvider ed è descritto dal documento di metadati SAML contenuto nel file SAMLMetaData.xml, che è stato scaricato separatamente dal sito web del provider di servizi SAML.

New-IAMSAMLProvider -Name MySAMLProvider -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)

Output:

arn:aws:iam::123456789012:saml-provider/MySAMLProvider

• Per informazioni dettagliate sull’API, consulta CreateSAMLProvider nella documentazione di riferimento dei cmdlet di AWS Strumenti per PowerShell (V5).

Per un elenco completo di AWS Guide per sviluppatori SDK ed esempi di codice, consulta L'utilizzo di questo servizio con un AWS SDK. Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.