이 페이지는 기계 번역되었습니다. 원본은 영어 페이지이며, 내용이 다를 경우 영어 버전이 우선합니다.

관리자 가이드: Ascripto와 Google Workspace

최종 검토일: 2026년 11월 9일

무언가를 허용해 달라는 요청을 받은 Google Workspace 관리자 또는 최고 관리자, 그리고 Ascripto가 무엇에 접근하는지 평가하는 모든 분을 위한 가이드입니다. 작동 방식부터, Google의 용어로 설명합니다.

Ascripto가 무엇을 누구에게 요청하는가

권한 부여부여하는 사람위치허용되는 것
로그인Ascripto를 사용하는 각 사람Google 로그인openid, email, profile. 신원은 Google 계정의 변하지 않는 식별자(subject)와 호스팅 도메인을 기준으로 하며, 이메일 주소를 기준으로 하지 않습니다
디렉터리, 읽기 전용Google Workspace 관리자Ascripto에서 이어지는 OAuth 동의(환영 페이지 또는 설정 → 연결)admin.directory.user.readonly 및 admin.directory.domain.readonly: 사용자와 그 이름, 직함, 부서, 전화번호, 조직 단위, 맞춤 속성, 그리고 조직의 확인된 도메인. 그룹은 읽지 않습니다
서명최고 관리자관리 콘솔 → 보안 → 액세스 및 데이터 컨트롤 → API 관리 → 도메인 전체 위임 관리Ascripto의 서비스 계정에 대한 www.googleapis.com/auth/gmail.settings.basic. 서비스 계정의 클라이언트 ID는 페이지에 표시됩니다. users.settings.sendAs에만 사용합니다

Ascripto는 메일을 읽거나 보내거나 삭제하지 않습니다. Ascripto의 Google 데이터 사용은 제한적 사용(Limited Use) 요건을 포함한 Google API 서비스 사용자 데이터 정책(Google API Services User Data Policy)의 적용을 받으며, 그 선언은 ascripto.com/ko/privacy/의 개인정보처리방침에 있습니다.

Marketplace 설치가 아니라 도메인 전체 위임인 이유

이유는 두 가지이며, 둘 다 Marketplace 등록이 생긴 뒤에도 그대로 적용됩니다:

  1. 호출하는 사람 자신의 사서함이 아닌 사서함에서 별칭(send-as) 서명을 읽거나 쓰는 것은 도메인 전체 권한을 가진 서비스 계정 클라이언트만 할 수 있습니다. 사용자별 동의로는 불가능합니다.
  2. Google에는 gmail.settings.basic의 읽기 전용 버전이 없습니다. 점검은 읽기만 하지만, 이 권한은 어쩔 수 없이 쓰기도 함께 허용합니다.

Google은 2026년 10월 17일에 Ascripto의 OAuth 앱(브랜딩 및 민감한 범위)을 확인했으므로, 디렉터리 권한의 동의 화면에는 ‘확인되지 않은 앱’ 경고가 표시되지 않습니다. 서명을 위한 위임 항목은 여전히 관리 콘솔에서 직접 만들며, 범위는 위 표에 있는 것입니다.

주기와 작동 방식

작업주기방식
디렉터리 변경발생하는 즉시: Google이 변경마다 Ascripto에 알리며, 해당 사용자를 그때, 1분 후, 5분 후에 읽습니다Admin SDK Directory API users.watch, 변경 종류(추가, 변경, 삭제, 복원)마다 채널 하나, 이틀마다 갱신하고 channels.stop으로 중지. 해당 사용자는 users.get으로 읽습니다
디렉터리 읽기매시간, 알림 채널이 없는 동안에는 15분마다, 그리고 지금 읽기를 누를 때Admin SDK Directory API users.list, domains.list
점검하루에 한 번, 그리고 다시 확인을 누를 때구성원마다 sendAs.list. 기본 주소의 서명을 디렉터리 기록과 비교합니다
배포검토를 거친 배포 때, 그 뒤로는 입사자와 변경된 기록에 대해 자동으로구성원마다 sendAs.patch, 초당 약 20건 쓰기. 각 사서함을 먼저 읽고, ‘최신 서명도 다시 쓰기’를 선택하지 않은 한 다를 때만 씁니다
가져오기요청 시선택한 구성원에 대해 sendAs.get. 값을 그 구성원의 디렉터리 기록과 대조합니다

sendAs.update가 아니라 sendAs.patch를 사용하므로, 배포가 구성원의 표시 이름, 답장 주소, 별칭 플래그를 지우는 일은 없습니다. 새 메일 서명만 씁니다. Gmail API에는 답장 및 전달용 선택에 대한 필드가 없으므로, 서명의 답장 버전은 Gmail에 배포되지 않습니다.

점검이 비교하는 것

구성원별로, Gmail이 새 메시지에 사용하는 서명을 디렉터리 기록과 비교합니다. 발견 사항:

문제검사
서명 없음서명이 비어 있음
이름 누락구성원의 이름이 텍스트에 없음
직함 누락디렉터리의 직함이 텍스트에 없음
직장 전화번호 누락디렉터리의 직장 전화번호가 텍스트에 없음
로고 없음서명에 로고 이미지가 없음
읽을 수 없음Google이 사서함을 거부함. 따로 집계하며, 브랜드 일치나 불일치로 세지 않습니다

검사하지 않으며 숫자 옆에 그렇게 표시하는 것: 구성원이 답장과 전달용으로 따로 선택할 수 있는 서명(Gmail이 웹 설정에 보관하며, 어느 것이 사용 중인지 알려 주는 API가 없습니다), Gmail 앱 안에서 설정한 ‘모바일 서명’(기기에만 저장되어 어떤 API로도 보이지 않습니다), 글꼴, 크기, 색상, 그리고 배포된 내용 외에 구성원이 덧붙인 모든 것.

배포가 쓰는 것

해당 구성원용으로 렌더링한 HTML(Gmail 서명은 HTML 문자열이어서 이미지를 포함할 수 없으므로, 이미지는 img.ascripto.com 아래 워크스페이스 전용 이름에서 호스팅됩니다)과 그에 대응하는 일반 텍스트입니다. Gmail은 이를 웹과 Gmail 앱에 적용합니다. 디렉터리에서 정지된 구성원, 주소가 조직의 도메인 밖에 있는 구성원, 어떤 서명도 적용되지 않는 구성원은 배포에서 건너뜁니다.

퇴사자

디렉터리에서 제거된 구성원은 Ascripto의 휴지통으로 이동하고(기본 7일, 설정 → 연결에서 최대 1년까지 설정 가능) 더 이상 관리되지 않습니다. Ascripto는 그 사서함에 다시는 쓰지 않으며, 이미 있는 서명을 지우지도 않습니다. 정지된 사용자에게는 정지된 동안 쓰지 않습니다.

이중 서명

관리 콘솔(앱 → Google Workspace → Gmail → 규정 준수)에서 ‘바닥글 추가’(Append footer)가 사용 설정되어 있으면, Google은 Ascripto가 쓰는 서명을 포함해 모든 사용자의 서명 아래에 바닥글을 추가합니다. Ascripto가 법적 문구를 담게 되면 바닥글이 설정된 모든 조직 단위에서 바닥글을 끄세요.

장애 유형과 제품의 표시 방식

일어난 일Ascripto에 표시되는 내용해결 방법
위임 항목이 없거나 삭제됨‘Google이 사서함 열기를 거부했습니다. 관리 콘솔에서 서명 액세스가 철회되었을 수 있습니다.’ 점검 또는 배포가 멈추며, 집계는 진행된 데까지 유지됩니다클라이언트 ID와 범위를 다시 추가합니다. 토큰 엔드포인트에서 감지되므로(unauthorized_client) 그사이 어떤 사서함도 건드리지 않습니다
디렉터리 동의가 철회되었거나 동의한 관리자가 역할을 잃음설정 → 연결: ‘연결이 철회되었습니다. 디렉터리를 다시 읽으려면 다시 연결하세요.’현재 관리자로 다시 연결
Google이 새 위임을 반영하는 데 시간이 걸림‘아직 허용되지 않았습니다’, 20초마다 다시 확인기다립니다. Google 문서에 따르면 최대 24시간이며, 보통은 몇 분입니다
Ascripto 쪽에서 확인 또는 읽기가 실패함그렇다고 표시하고 다시 시도합니다할 일 없음

Ascripto의 권한 철회하기

  1. 서명: 관리 콘솔 → 보안 → 액세스 및 데이터 컨트롤 → API 관리 → 도메인 전체 위임 관리 → Ascripto 클라이언트 → 삭제. 점검과 배포가 즉시 멈춥니다.
  2. 디렉터리: 동의한 관리자가 자신의 Google 계정 → ‘연결된 앱’(myaccount.google.com/linkedapps)에서 Ascripto를 삭제합니다(또는 설정 → 연결 → Google이 다음 읽기를 거부하면 연결이 철회된 것으로 표시됩니다).
  3. 이미 기록된 서명은 구성원의 Gmail에 남습니다. Ascripto는 그것을 지우지 않습니다.

데이터 처리

요금이 청구되는 구성원

Google Workspace에서 요금이 청구되는 구성원이란, 배포가 서명을 썼거나 배포 또는 점검이 서명이 여전히 있음을 확인하여 그달 중 어느 시점에든 Gmail에 현재 서명이 들어 있었던 모든 구성원입니다. 그달 내내 정지되었거나 제거된 구성원은 집계되지 않습니다. 그달의 현재까지 집계는 설정 → 결제에 있습니다.

출처