이 연동은 언제 필요한가요?
자동화의 외부 시스템 호출 실행 동작은, 우리 팀이 쓰는 다른 웹사이트나 서비스(예: 회사 내부 재고관리 시스템, 외부 업체가 제공하는 API 등)에 접속해서 데이터를 가져오거나 보낼 수 있습니다. 이때 "누구인지 증명"하는 로그인 정보가 필요한데, 이걸 미리 안전하게 등록해두는 곳이 바로 이 설정입니다.
등록 방식은 두 가지가 있습니다. 접속하려는 곳이 어떤 방식을 요구하는지에 따라 골라 쓰면 됩니다.
사이트 로그인 — 우리가 평소 웹사이트에 로그인하듯 아이디/비밀번호로 접속하는 방식입니다.
API 토큰 — 서비스 개발사가 미리 발급해준 긴 문자열(토큰)을 이용해 접속하는 방식입니다. 아이디/비밀번호 없이 이 토큰 하나로 신원을 증명합니다.
용어 설명
API — 사람이 화면을 보고 클릭하는 대신, 프로그램끼리 데이터를 주고받을 수 있게 만들어둔 통로입니다.
토큰(Token) — 로그인 비밀번호 대신 쓰는 긴 암호 문자열입니다. 발급받은 서비스 화면(주로 "API 키", "액세스 토큰" 등의 이름으로) 어딘가에서 확인할 수 있습니다.
헤더(Header) — 요청을 보낼 때 본문과 별도로 함께 딸려 보내는 부가 정보입니다. 토큰은 보통
Authorization이라는 이름의 헤더에 담아 보냅니다.
어떤 방식을 써야 할지 모르겠다면?
접속하려는 서비스의 안내 문서(개발 문서, API 문서)에 "아이디/비밀번호로 로그인"이라고 되어 있으면 사이트 로그인을, "API Key" 또는 "Bearer Token"을 헤더에 담아 보내라고 되어 있으면 API 토큰 방식을 선택하세요. 잘 모르겠다면 그 서비스를 도입한 담당자나 개발사 고객센터에 "API 인증 방식이 무엇인가요?"라고 문의해보시는 것을 권장합니다.
등록 방법 — 사이트 로그인 (아이디/비밀번호)
팀 페이지 → 오른쪽 위 톱니바퀴(팀 설정) 아이콘 클릭 (팀 소유자만 접근 가능).
자동화 설정 — 사이트 로그인 정보 섹션에서 사이트 로그인 탭이 선택된 상태인지 확인합니다(기본으로 선택되어 있습니다).
라벨(구분용 이름, 예: "재고관리 시스템"), 아이디, 비밀번호를 입력합니다.
추가 버튼을 클릭합니다.
등록 방법 — API 토큰
같은 섹션에서 API 토큰 탭을 클릭합니다.
라벨(구분용 이름), 헤더 이름(대부분
Authorization그대로 두면 됩니다), 헤더 값(서비스에서 발급받은 토큰, 예:Bearer xxxxxxxx)을 입력합니다.추가 버튼을 클릭합니다.
💡 아이디/비밀번호나 토큰은 저장하는 순간 암호화되어 전송되고, 이후에는 이 화면을 포함해 어디서도 다시 볼 수 없습니다. 값이 바뀌면 새로 등록해야 합니다.
자동화에서 사용하기
자동화 캔버스에서 외부 시스템 호출 액션을 선택하면 인증 드롭다운이 나타납니다. 여기서 방금 등록한 라벨을 선택하고, 접속할 주소(URL)와 필요한 값을 입력하면 됩니다.