커스텀 인증 관리

본 장에서는 AnyAPI WebAdmin의 [Auth] 메뉴에서 커스텀 인증 설정을 관리하는 방법에 대해 설명합니다.

커스텀 인증 기능

커스텀 인증 기능은 정해진 사양이 없는 사용자 정의된 HTTP 인증 서버를 지원하기위해 HTTP요청의 바디, 헤더, 쿼리를 자유롭게 설정할 수 있는 인증 기능입니다.

다음은 커스텀 인증에서 제공하는 기능 항목입니다.

  • 사용자 정의 외부 경로를 통한 커스텀 인증 기능

    사용자가 원하는 경로를 지정하여 사용할 수 있으며 서버 그룹을 이용하여 인증 서버간 분배 및 Fail Over를 지원합니다.

  • 커스텀 인증시 토큰값 인코딩 및 헤더 쿼리 전달 기능

    인증 정보가 담긴 토큰값을 어떤 헤더에서 가져올 건지와 토큰에 대한 정보를 정의할 수 있습니다.

  • 커스텀 인증 토큰 캐시 기능

    인증이 성공하면 일정 시간동안 인증된 토큰 값과 응답을 캐시하여, 인증 서버와의 잦은 통신을 방지합니다.

  • 커스텀 인증 응답 맵핑 기능

    커스텀 인증 서버로부터 받은 응답을 헤더나 쿼리에 맵핑하여 타겟 서버와의 통신에 활용하는 기능입니다. 리소스 Modulation 화면에서 ${auth.response.<key>} 예약어를 이용하여, 커스텀 인증 서버의 응답 값 중 특정 키를 헤더나 쿼리로 전달할 수 있습니다.

커스텀 인증 관리

커스텀 인증 조회

설정한 커스텀 인증 목록을 조회할 수 있습니다.

  1. AnyAPI WebAdmin의 메뉴 영역에서 [Auth] > [Custom Auth] 메뉴를 선택합니다.

  2. [Custom Auth] 화면이 열리면 'Custom Auth List Table’에서 커스텀 인증 목록을 확인할 수 있습니다.

    figure custom auth list main

    조회 항목에 대한 설명은 다음과 같습니다.

    항목 설명

    auth ID

    커스텀 인증의 고유 식별 ID입니다. 커스텀 인증을 생성할 때 자동으로 생성합니다.

    Issuer URL

    커스텀 인증을 수행하기 위해 호출되는 인증 서버의 URL입니다.

커스텀 인증 추가

새로운 커스텀 인증을 생성할 수 있습니다.

  1. AnyAPI WebAdmin의 메뉴 영역에서 [Auth] > [Custom Auth] 메뉴를 선택합니다.

  2. [Custom Auth] 화면이 열리면 'Custom Auth List Table’에서 figure api create icon 버튼을 클릭합니다.

    figure custom auth add click
  3. 'Custom Auth 생성' 대화상자가 열리면 커스텀 인증 정보를 설정한 후 figure save icon 버튼을 클릭합니다.

    각 설정 항목에 대한 자세한 설명은 커스텀 인증 설정 항목을 참고합니다.

    figure custom auth add

커스텀 인증 수정

커스텀 인증의 설정 정보를 수정할 수 있습니다.

  1. AnyAPI WebAdmin의 메뉴 영역에서 [Auth] > [Custom Auth] 메뉴를 선택합니다.

  2. [Custom Auth] 화면이 열리면 'Custom Auth List Table' 목록에서 정보를 수정할 커스텀 인증을 클릭합니다.

    figure custom auth list click
  3. Detail Setting 패널이 화면 오른쪽에 열리면 figure api edit icon 버튼을 클릭합니다.

    figure custom auth update
  4. 수정 모드로 전환되면 수정할 항목의 값을 설정한 후 figure save icon 버튼을 클릭합니다.

    각 설정 항목에 대한 자세한 설명은 커스텀 인증 설정 항목을 참고합니다.

    figure custom auth update save

커스텀 인증 삭제

사용하지 않는 커스텀 인증을 삭제할 수 있습니다.

  1. AnyAPI WebAdmin의 메뉴 영역에서 [Auth] > [Custom Auth] 메뉴를 선택합니다.

  2. [Custom Auth] 화면이 열리면 'Custom Auth List Table' 목록에서 삭제할 커스텀 인증의 체크박스를 선택하고, figure api del icon 버튼을 클릭합니다.

    figure custom auth del
  3. '삭제 확인' 대화상자가 열리면 [Yes] 버튼을 클릭합니다.