MID 웹 서버 API 키 인증 구성

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기2분
  • API 키 인증을 사용하여 클라이언트에서 MID 웹 서버 확장으로 수신 요청을 인증합니다. API 인증은 요청을 인증하는 안전하고 간단한 방법입니다. MID 웹 서버 API 키를 만들거나 수정할 수 있습니다.

    시작하기 전에

    MID 웹 서버 확장 구성에 설명된 대로 API 키 인증을 사용하는 MID 웹 서버 확장을 만듭니다. 확장의 인증 유형 필드에서 API 키를 선택해야 합니다.

    필요한 역할: event_mgmt_admin

    이 태스크 정보

    기본적으로 인스턴스에서 생성할 수 있는 최대 API 키 수는 10입니다. 이 숫자를 변경하려면 시스템 속성 페이지에서 mid.webserver.max.api.keys 속성 값을 수정합니다.

    도메인 분리를 사용하는 동안 전역 도메인에서 작업할 때는 도메인에 관계없이 모든 확장에서 API 키를 사용할 수 있습니다. 특정 도메인에서 작업할 때는 해당 도메인, 해당 상위 도메인 및 전역 도메인의 확장에서 API 키를 사용할 수 있습니다.

    지정된 날짜에 만료되도록 API 키를 구성할 수 있습니다.

    API 키 인증을 사용하여 새 확장을 만들거나 API 키 인증을 사용하도록 기존 확장을 업데이트할 때 시스템은 확장에 사용 가능한 API 키를 확인합니다. 사용 가능한 API 키가 없으면 시스템에서 API 키를 만듭니다.

    프로시저

    1. 다음으로 이동 모두 > MID 서버 > 프로파일 및 배포 > MID 웹 서버 API 키.
    2. 새 API 키를 만들거나 기존 API 키를 수정합니다.
      • 새 API 키를 만들려면 다음을 수행합니다.
        1. 새로 만들기를 선택합니다.
        2. MID 웹 서버 API 키 양식에서 필드를 입력합니다.
          표 1. MID 웹 서버 API 키 양식
          필드 설명
          이름 API 키의 이름입니다.
          활성 API 키를 활성화하는 옵션입니다.
          인증 키 인증 키의 읽기 전용 인코딩 값입니다. 키를 구성한 후에는 값이 나타나지 않습니다.
          만료 API 키의 만료 날짜를 설정하는 옵션입니다.

          만료, 비활성화 또는 삭제된 API 키는 웹 서버 확장에서 수락하지 않습니다.

        3. 제출을 선택하여 API 키를 저장합니다.

          API 키가 MID 웹 서버 API 키 페이지에 나타납니다.

      • 기존 API 키를 수정하려면 다음을 수행합니다.
        1. 다음으로 이동 MID 서버 > 프로파일 및 배포 > MID 웹 서버 API 키.
        2. 페이지에서 API 키를 선택합니다.
        3. 관련 링크 섹션에서 API 키 보기를 선택합니다.
        4. MID 웹 서버 대화 상자에 나타나는 API 키를 복사합니다.

          API 키 인증으로 구성된 MID 웹 서버 확장에 연결할 때 확장이 액세스 권한이 있는 API 키를 요청의 인증 헤더에 다음 형식으로 배치합니다.

          키 <API_KEY>

          여기서 <API_KEY>API 키 보기 선택 후 표시되는 API 키의 값입니다.
        5. 제출을 선택합니다.