서비스 계정

소프트웨어(통합, 예약된 내보내기, 지원 데스크 등)를 위한 ID는 사람과 같은 역할을 가지며, 콘솔에 로그인할 필요도 없고, 추가 단계를 요구받지도 않습니다.

2단계 로그인은 모든 사람에게 적합하지만 모든 스크립트에는 적합하지 않습니다. 비밀번호로 로그인하는 프로그램은 입력할 수 없는 코드를 요구받기 때문입니다. 소프트웨어는 대신 서비스 계정을 사용하여 ID를 부여합니다. 서비스 계정은 개인과 마찬가지로 역할과 회사 정보를 보유하므로 모든 화면 권한, 조직 단위 제한 및 직무 규칙이 적용됩니다. 하지만 서비스 계정에는 아무도 아는 비밀번호가 없으며, 로그인 양식에서 비밀번호를 허용하지 않고, 콘솔의 개인 설정 또는 대화형 부분(환경 설정, 개인 설정, 대시보드, 어시스턴트, 2단계 설정, 시스템 콘솔)을 사용할 수 없습니다.

1. 플랫폼 열기 → 액세스 및 보안 → 액세스 → 서비스 계정(사용자 옆)에서 새 서비스 계정을 선택합니다.
2. 이메일 주소는 용도를 명확히 알 수 있도록 (예: nightly-export@service.yourcompany), 이메일 주소와 이메일의 기능에 대한 간단한 설명으로 지정하세요.
3. 해당 역할을 선택하세요. 필요한 작업을 수행하는 가장 제한적인 역할을 부여하세요. 예를 들어 구매 주문서만 표시할 수 있는 역할은 구매 주문서만 읽을 수 있는 키를 의미합니다.
4. 선택적으로 주소(IP 주소 또는 203.0.113.0/24와 같은 IPv4 범위)로 제한하거나, 토큰 수명을 단축하거나, 만료일을 지정할 수 있습니다.
5. 생성하세요. 비밀 키는 한 번만 표시됩니다. 사용할 프로그램에 복사해 두세요. 이 키는 지문으로만 저장되며 다시 읽어낼 수 없습니다.

이 프로그램은 비밀 키를 몇 분 동안 유효한 토큰으로 교환하고, 다른 베어러 토큰처럼 모든 호출 시에 토큰을 전송합니다.

POST /api/auth/service-token
{ "client_id": "nightly-export@service.yourcompany", "secret": "txs_…" }

→ { "token": "…", "expires_in": 3600, "companies": [ … ] }

GET /api/scm/purchase-orders
Authorization: Bearer <token>
X-Company: <company id>

• 새로운 비밀 키가 발급되면 이전 키는 즉시 무효화됩니다. 이미 발급된 토큰은 사용자가 직접 종료하지 않는 한 만료일까지 유효합니다.
• Revoke는 비밀 키를 중지시키고 다음 요청 시 모든 활성 토큰을 종료합니다.
• 계정을 비활성화하면 계정이 더 이상 사용되지 않지만, 해당 계정이 기록한 모든 감사 행에는 계정 이름이 남아 있습니다.
• 모든 토큰은 세션입니다. 플랫폼 → 액세스 → 웹 및 사용자 세션에서 확인할 수 있으며, 다른 사용자 세션과 마찬가지로 해당 위치에서 종료할 수 있습니다.
• 잘못된 비밀번호를 입력하면 계정이 잠기는 것과 동일한 상황이 발생하며, 모든 정보 교환 내역은 감사 로그에 기록됩니다.
• 서비스 계정을 관리할 수는 있지만 관리자가 아닌 사람은 자신이 보유한 역할만 부여할 수 있으며, 관리자 역할은 절대 부여할 수 없습니다.

지원 데스크 계정

모든 배포에는 별도로 생성할 필요가 없는 서비스 계정(support-desk@service.tranxact)이 하나 포함되어 있습니다. 이 계정은 배포 설치 시 공급업체가 설정한 비밀 키를 사용하여 배포 자체에서 프로비저닝되므로, 회사에서 티켓 처리를 위해 별도의 작업을 수행할 필요가 없습니다. 이 계정은 모든 회사에서 지원 데스크 역할을 담당하며, 지원 티켓과 첨부 파일을 읽고 답변하는 권한을 가집니다. 단, 다른 모듈이나 화면을 열 수는 없습니다. 이 계정은 "배포에 의해 설정됨"으로 표시되며, 권한 취소는 회사에서 결정하며 배포에서 취소된 권한을 무효화할 수 없습니다.