10.5. 이벤트 스트림에 대한 정적 UUID(Universal Identifier)
이벤트 스트림 서비스가 다시 생성되는 경우에도 웹 후크 URL이 일관되게 유지되도록 정적 UUID(Universal Identifier)를 사용하여 이벤트 스트림을 구성할 수 있습니다.
이 기능은 방화벽 또는 타사 Webhook와 같은 외부 시스템을 새 URL을 사용하도록 쉽게 재구성할 수 없는 재해 복구 시나리오와 관련이 있습니다. 정적 UUID 사용을 고려할 때의 주요 개념은 다음과 같습니다.
- 재해 복구 지원
-
정적 UUID를 사용하면 서비스 재생성 시
https://your-eda-server.com/api/eda/v1/external_event_stream/{uuid}/형식을 따르는 외부 웹 후크 URL이 변경되지 않습니다. - 고유성
- 제공하는 UUID는 시스템의 모든 기존 이벤트 스트림에서 고유해야 합니다.
- 보안 경고
- 정적 UUID를 사용하면 Webhook URL을 예측할 수 있으므로 보안이 저하될 수 있습니다. URL 일관성이 중요한 경우에만 이 기능을 사용하고 강력한 인증 및 네트워크 제한과 같은 강력한 추가 보안 조치를 구현했습니다. 일반 작업의 경우 항상 자동 생성(동적) UUID를 사용합니다.
강력한 인증 정보 유형(HMAC, mTLS) 및 네트워크 제한과 같은 추가 보안 조치가 적용되었는지 확인해야 합니다.
10.5.1. 정적 UUID(API 메서드)로 이벤트 스트림 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
정적 사용자 지정 UUID를 사용하려면 API를 사용하여 이벤트 스트림을 업데이트해야 합니다. 생성을 위한 API 끝점은 POST /api/eda/v1/event-streams/ 입니다.
사전 요구 사항
- Ansible Automation Platform 2.6-next
프로세스
- Ansible Automation Platform에 로그인합니다.
- 탐색 패널에서 개요 를 선택합니다.
URL에서 Overview 를 API 끝점,
api/eda/v1/(예:https://<platformURL>.com/api/eda/v1/)로 바꿉니다.Api V1 Root페이지에는 EDA 리소스 URL 목록이 표시됩니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
목록 끝에
"eventstream-list"URL을 클릭합니다. 그러면 이벤트 스트림 목록 페이지로 이동합니다. 업데이트하려는 이벤트 스트림 UUID의
"id"를 찾아 복사합니다. 이는 이벤트 스트림 데이터가 끝날 때 찾을 수 있습니다.Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
URL 끝에 ID를 붙여넣고(예: https://<platformURL>.com/api/eda/v1/<id#> ) Enter 를 누릅니다. 현재
"uuid"값을 포함하여 이벤트 스트림 인스턴스 페이지가 표시됩니다. -
이벤트 스트림 인스턴스 페이지 끝에 있는 양식에서
"uuid"필드의 값을 선택한 고유한 정적 문자열로 업데이트합니다. - 패치 를 클릭합니다.
검증
- 이벤트 스트림의 UUID가 새 정적 문자열로 업데이트되었는지 확인합니다.