토큰을 사용하여 DevOps 변경 속도에 인바운드 이벤트를 전송하는 웹후크 생성
토큰 기반 인증을 사용하여 DevOps Change Velocity에 인바운드 이벤트를 보내려면 웹후크를 생성해야 합니다.
ServiceNow 인스턴스에 인바운드 이벤트를 보내려면 다음 API 엔드포인트 구조를 사용해야 합니다.
<instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>도구 기록에서 수동으로 구성을 선택하거나 도구를 온보딩하는 동안 구성 단계에서 도구 ID, 인스턴스 URL 등과 같은 상세 정보를 복사할 수 있습니다. 그런 다음 해당 필드에서 복사 를 선택하여 값을 클립보드에 복사할 수 있습니다. 필드 레이블이 복사됨으로 변경되지만 여러 번 복사할 수 있습니다. 다음 이미지는 DevOps 변경 속도에서 GitHub 도구에 대한 값을 복사할 수 있는 페이지를 표시합니다.
토큰 인증의 경우 엔드포인트가 보안될 때 권한 부여 헤더 또는 쿼리 매개변수의 일부로 토큰을 전달해야 합니다. 다음 방법 중 하나를 사용할 수 있습니다.
- 헤더 이름: 권한 부여 헤더 값: sn_devops 형식을 사용하여 토큰을 헤더로 전달합니다. DevOpsToken<ToolId>:<Token>, 여기서 <ToolId>는 도구의 ID이고 <Token>은 도구 기록 페이지에서 복사한 인증 토큰입니다.
- 토큰을 URL에 쿼리 매개변수로 전달합니다. <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>&ni.nolog.token=<Token>, 여기서 <ToolId>는 도구의 ID이고 <Token>은 도구 기록 페이지에서 복사한 인증 토큰입니다.
기본 인증의 경우 다음 V1 엔드포인트를 사용할 수 있습니다. https://user:password@<instance_url>/api/sn_devops/v1/devops/tool/{capability}?toolId=<toolId>, 사용자 및 암호를 ServiceNow 자격 증명으로 바꿉니다.
사용자 지정 도구 또는 다른 인증 방법이 있는 경우 고유한 인증 논리를 구현할 수 있습니다. 예를 들어, 핸들러 클래스에서 authenticateToken 함수를 구현할 수 있습니다. 함수는 토큰을 확인하고 적절한 인증을 보장해야 합니다. 자체 인증 논리를 구현하려면 ServiceNow에서 관리자 역할이 있어야 합니다.