CreateSAMLProvider 사용하기

CreateSAMLProvider 사용하기 (SDK/CLI)

CreateSAMLProvider(SAML 공급자 생성) API를 활용하는 방법을 코드 예시로 정리했어요. 각 예시는 어떤 동작을 하는지, 어떤 파라미터를 쓰는지 순서대로 살펴볼 수 있어요.

출처: 문서

본문

다음 코드 예시들은 CreateSAMLProvider 를 어떻게 사용하는지 보여줘요.

AWS CLI

SAML 공급자 생성하기

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

이 예시는 IAM에 MySAMLProvider라는 새 SAML 공급자를 만들어요. SAMLMetaData.xml 파일의 SAML 메타데이터 문서로 설명돼요.

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

출력:

JavaScript(SDK v3)

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;
};

GitHub에 더 많은 내용이 있어요. AWS Code Examples Repository에서 전체 예시를 찾아 실행 방법을 배울 수 있어요.

PowerShell Tools (V4)

예시 1: IAM에 새 SAML 공급자 엔터티를 만들어요. 이름은 MySAMLProvider이고, SAML 서비스 공급자 웹사이트에서 별도로 다운로드한 SAMLMetaData.xml 파일의 SAML 메타데이터 문서로 설명돼요.

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

출력:

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

PowerShell Tools (V5)

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