AlphaKey

개요

로그프레소 소나와 AlphaKey를 연동해 두 가지 기능을 사용할 수 있습니다.

• SSO 로그인: SAML 2.0 기반으로 AlphaKey 계정을 통해 소나에 로그인합니다. 이 연동에서 소나는 SP(Service Provider), AlphaKey는 IdP(Identity Provider) 역할을 담당합니다.
• 감사 로그 수집: AlphaKey의 SSO/IAM 감사 이벤트를 소나로 전송받아 적재합니다. AlphaKey가 소나로 로그를 전송하는 푸시 방식입니다.

두 기능은 독립적이며, SSO만 사용하거나 로그 수집만 사용할 수도 있습니다. 설정 값은 AlphaKey와 소나 양쪽에 나누어 입력하며, 한쪽에서 입력한 값이 있어야 다른 쪽 값이 만들어집니다. 아래 순서대로 진행하세요.

1. AlphaKey에 앱을 등록하고 Sonar 주소를 입력합니다.
2. AlphaKey가 발급한 IdP 정보를 소나 SSO 설정에 입력합니다.
3. AlphaKey → 소나 순서로 연동을 활성화하고 테스트합니다.
4. 소나에 수집기를 등록하고, 그 수신 주소를 AlphaKey에 로그 전송 대상으로 지정합니다.

적용 범위

요구 사항

AlphaKey 앱 등록

AlphaKey에 로그프레소 앱을 등록하고 연동 정보를 입력합니다. 이 단계에서 발급되는 IdP 정보가 소나 SSO 설정의 입력 값이 됩니다.

단계 1: 앱 추가

AlphaKey 관리자 페이지에서 AlphaKey > 앱 > 앱 현황으로 이동한 뒤 앱 추가를 클릭합니다.

앱 추가 방식 선택에서 AlphaKey에 등록된 앱 추가를 선택하고 다음을 클릭합니다.

Logpresso를 검색해 앱을 선택하고 적용을 클릭합니다.

계약 정보를 입력하면 앱 연동 페이지가 생성됩니다.

단계 2: 연동 정보 입력

생성된 앱 연동 페이지에 Sonar 주소를 입력합니다.

입력 예시입니다.

예시) 로그프레소 소나 분석서버 URL : https://sample.logpresso.cloud 인 경우 아래와 같이 설정합니다.

클라이언트 페이지 : https://sample.logpresso.cloud
리다이렉트 URL    : https://sample.logpresso.cloud/sso/alphakey-saml2
엔티티 ID        : https://sample.logpresso.cloud

단계 3: IdP 정보 확인

입력을 완료한 뒤 IDP 정보 보기를 클릭합니다. 기본정보, Meta data, 인증서 PEM 세 탭의 값을 다음 단계에서 소나에 입력하므로 창을 열어 둔 채로 진행하세요.

로그프레소 SSO 설정

시스템 > SSO에서 추가를 클릭하고, AlphaKey의 앱 연동 페이지와 IDP 정보 창에 표시된 값을 아래와 같이 입력합니다.

ACS URL과 SP 식별자는 AlphaKey에 입력한 리다이렉트 URL·엔티티 ID와 문자열이 정확히 일치해야 합니다.

SSO URL은 Meta data 탭의 SingleSignOnService 요소에 있는 Location 주소를 입력합니다.

IdP 식별자는 기본정보 탭의 발급자(IDP 엔티티 ID)를 입력합니다.

X.509 인증서는 인증서 PEM 탭에서 BEGIN CERTIFICATE, END CERTIFICATE 두 줄을 제외한 Base64 본문만 복사해 입력합니다.

연동 활성화

AlphaKey와 소나 양쪽 입력이 끝나면 아래 순서대로 활성화합니다.

AlphaKey에서 적용을 클릭하고, 소나에서 저장을 클릭합니다.

이어서 소나의 SSO 목록에서 등록된 AlphaKey SAML 2.0의 활성화 스위치를 켭니다. AlphaKey에서는 연결테스트를 클릭해 소나 로그인 화면이 호출되는지 확인합니다.

연결테스트가 정상이면 연동을 클릭합니다. AlphaKey 앱 현황에 Logpresso 앱이 생성되면 SSO 연동이 완료됩니다.

로그프레소 수집 설정

AlphaKey 감사 로그는 AlphaKey가 소나로 직접 전송하는 방식입니다. 소나에 수신용 수집기를 먼저 만들고, 여기서 정한 콜백 이름으로 수신 주소가 결정됩니다.

단계 1: 수집기 추가

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

단계 2: AlphaKey 로그 전송 대상 지정

AlphaKey 관리자 페이지에서 감사 로그 전송 대상을 아래와 같이 지정합니다.

다음은 전송 주소 예시입니다.

https://sample.logpresso.cloud/log/alphakey

설치 후 검증

SSO 로그인 확인

소나 로그인 화면에 AlphaKey SAML 2.0 로그인이 추가되었는지 확인하고, AlphaKey 계정으로 로그인합니다.

• 정상: AlphaKey 인증을 거쳐 소나에 로그인됩니다.
• 비정상: 서명 검증 오류가 발생하면 X.509 인증서에 BEGIN/END 라인이 포함되지 않았는지, 리다이렉트 URL과 ACS URL이 동일한지 확인합니다.

로그 수집 확인

아래 쿼리로 수집이 실제로 동작하는지 확인합니다. IAM_ALPHAKEY는 수집기에 지정한 테이블 이름으로 바꿔 실행합니다.

table duration=10m IAM_ALPHAKEY
| stats count

• 정상: 10분 내 수집된 레코드 수가 1 이상입니다.
• 비정상: 0이면 AlphaKey의 로그 전송 설정(호스트·경로), 수집기의 콜백 이름 일치 여부, 수집 노드로의 네트워크 도달(HTTPS/443 Inbound)을 재확인합니다.

필드가 정상적으로 분리되었는지는 아래 쿼리로 확인합니다.

table duration=10m IAM_ALPHAKEY
| fields _time, event_type, event_group, user, user_name, src_ip, msg

참고 자료

• 로그프레소 소나 공식 문서
• SSO 설정 가이드
• 수집기 설정 가이드