📌 Atlassian 이란
  • 소프트웨어 개발자들을 타깃으로 하는 전사 협업 관리 소프트웨어
  • Confluence + JIRA + Bitbucket + Bamboo 등
  • 업무관리, IT 서비스관리, 애자일 및 DevOps 등의 기능 제공
  • Confluence : 팀 단위 관리
  • JIRA : 프로젝트 단위 관리


📌 [On-Premise] webMethods - [SaaS] Atlassian 연동 방안 (컨플루언스, 지라)




✔️ Atlassian (Cloud) REST API

✔️ Atlassian REST API 의 기본인증 (Confluence Cloud, JIRA Cloud 에서 사용 가능)
  • 기본 인증은 Atlassian Account 기반 인증
    • 우측 위 아이콘 > Profile > Manage Your Account 에서 확인 가능

  • Account > Security > API Token 에서 생성
( Security 화면 )


( API Token 생성 )


(생성 된 키는 복사해 둔다 (Close 시 다시 볼 수 없음))


  • Authorization Header (Basic Auth)
    • Username : 가입 이메일
    • Password : API 토큰
  • → Basic + Base64-Encoded("username:password")
    ex) Basic c3VoMTAyN0BnbWFpbC5jb206WFdnQTVMM3o3QjA5RVBzMzVCbmszNjRC
  • JIRA 는 webMethods CloudStreams Connector 에서 커넥션 생성 및 API 호출을 (Cloud Connector Service) 템플릿으로 제공


✔️ Atlassian Cloud Application 생성 및 인증 설정
  • Cloud App 생성 가이드


✔️ Space 란 = Workspace
  • Space 는 하나의 워크스페이스로 Personal Space 와 프로젝트 단위 팀 스페이스로 구분 됨
  • 스페이스 단위 태그로 관리 가능





※ API 호출 테스트 예시

✔️ Confluence Space 관련 API
  • GET Space
    • [GET] /wiki/rest/api/space

(호출 예시)

→ Space 마다 id, Key 값으로 구분
→ Space Key 란 특정 Space 에 대한 URL의 일부를 형성하는 짧고 고유한 식별자
→ Personal Space 의 Space key는 무작위로 생성 (위 Response의 ~로 시작하는)
→ 팀 스페이스에는 고유 식별자를 추가 (숫자+문자, 255자)

  • 이외 인터페이스 개발에 OPEN API Spec 기반으로 Parameter, Request Body 작업 해야 할 듯 함
  • Documentation 참고



✔️ JIRA Project 관련 API
  • GET Project
    • [GET] /rest/api/3/project
(호출 예시)

→ CloudStreams Connector Service 도 호출에서 문제가 있는 듯 해보인다, output 템플릿이 맞지 않아서 인 듯
→ API spec 문서 기반으로 개발 해야 할 듯 함