홈

무엇을 도와드릴까요?

AI는 실수할 수 있습니다. 중요한 작업은 확인 후 실행하세요.

앱스

배포할 앱

Argos에 등록된, 이 학교가 설치할 수 있는 앱입니다. 목록은 gcgos가 정하지 않습니다.

대상 단말

MDM 화면과 같은 선택입니다. 퀵 그룹이나 클래스룸에서 옮겨 온 선택도 그대로 보입니다.

배포는 Argos 대기열에 넣는 것까지입니다. 단말이 깨어나야 실제로 설치되며, 잠들어 있으면 MDM 화면의 푸시(깨우기)로 깨울 수 있습니다.

퀵 그룹

AI로 만들기 (Sonnet)

왼쪽에서 퀵 그룹을 고르거나 새로 만드세요.

퀵 그룹은 gcgos에만 저장되는 묶음입니다. Argos의 학급 그룹은 바뀌지 않습니다.

	이름	시리얼	Argos 그룹	플랫폼

클래스룸

제목에 2026이 들어간 수업만

왼쪽에서 수업을 고르세요.

수업 명단은 구글에서 읽어 오기만 합니다. gcgos는 수업이나 학생을 바꾸지 못합니다.

안정적인 배포 선택 0대

	학생	학번	기기	시리얼	연결

학교

–

학년

반

주차

노란색으로 표시된 칸은 컴시간에 등록된 변경(대체) 수업입니다. 괄호 안은 담당 선생님입니다.

아이디	이름	권한	상태	PIN	최근 로그인	작업

gcgos에서 일어난 로그인·계정·정책 변경 기록입니다.

시각	사용자	동작	상세

Argos 공용 계정으로 나간 전체 요청입니다. "실행자"가 비어 있으면 gcgos 밖(Argos 콘솔 등)에서 실행된 요청입니다.

시각	요청	실행자	대상	완료	상태

구글 연동

학교 구글 계정과 gcgos를 잇는 설정을 모아 둡니다.

구글 워크스페이스

학교 구글 계정으로 로그인하고, 조직도를 불러옵니다. 아래 네 단계를 위에서부터 따라가면 됩니다 — 구글 콘솔에서 무엇을 눌러야 하는지도 단계마다 적어 두었습니다. 최상위 계정만 바꿀 수 있습니다.

1 학교 계정으로 로그인 열기 선생님들이 비밀번호 대신 구글 계정으로 들어옵니다.

구글 클라우드 콘솔에서 할 일

console.cloud.google.com 에 학교 계정으로 들어가, 프로젝트를 하나 고르거나 새로 만듭니다.
API 및 서비스 → OAuth 동의 화면에서 User Type을 내부로 만듭니다. 내부이면 구글 심사를 받지 않아도 됩니다.
사용자 인증 정보 → 사용자 인증 정보 만들기 → OAuth 클라이언트 ID에서 웹 애플리케이션을 고릅니다.
승인된 리디렉션 URI에 이 주소를 그대로 넣습니다. 한 글자만 달라도 로그인 마지막 단계에서 막힙니다.
만들어진 클라이언트 ID와 클라이언트 보안 비밀번호를 오른쪽 칸에 넣고 저장합니다.

gcgos가 구글에 요청하는 것은 openid · email · profile 셋뿐입니다. 메일·드라이브·문서는 읽지 않습니다.

워크스페이스 도메인

이 도메인 계정만 로그인됩니다. 개인 gmail은 주소가 비슷해도 막힙니다.

OAuth 클라이언트 ID

OAuth 클라이언트 보안 비밀번호

2 조직도 읽기 권한 주기 학교 조직도를 읽어 오려면 서비스 계정이 하나 필요합니다.

콘솔 두 곳에서 할 일

클라우드 콘솔 IAM 및 관리자 → 서비스 계정에서 서비스 계정을 하나 만듭니다. 역할(role)은 주지 않아도 됩니다.
그 계정의 키 → 키 추가 → 새 키 만들기 → JSON으로 키 파일을 내려받습니다.
키 파일을 서버에 두고 컨테이너에 붙입니다. 서버의 .env에 호스트 디렉터리를 적고 다시 올리세요.
GOOGLE_SA_KEY_DIR=/srv/gcgos/keys
관리 콘솔 admin.google.com → 보안 → 액세스 및 데이터 제어 → API 제어 → 도메인 전체 위임 관리 → 새로 추가.
클라이언트 ID 칸에는 서비스 계정의 고유 ID(숫자)를 넣습니다. 주소가 아니라 숫자입니다 — 이걸 바꿔 넣는 것이 403이 나는 가장 흔한 이유입니다.
키 파일을 저장하면 여기에 값이 나옵니다
OAuth 범위 칸에 아래 줄을 통째로 붙여 넣습니다. 쉼표로 이어진 네 개이며, 조직도 하나와 클래스룸 셋입니다.
https://www.googleapis.com/auth/admin.directory.user.readonly
클래스룸 범위를 빼면 조직도는 되고 클래스룸 화면만 403으로 막힙니다. 그 403은 어느 범위가 없는지 말해 주지 않으니, 지금 네 개를 다 넣어 두는 편이 낫습니다.
관리 콘솔의 슈퍼관리자 주소 하나를 오른쪽 대신 조회할 관리자 칸에 넣습니다.

준 권한은 읽기 전용입니다. gcgos는 학교 구글 계정을 만들지도, 고치지도, 지우지도 못합니다 — 조심해서가 아니라 그렇게 만들어져 있습니다.

서비스 계정 키 파일 경로

컨테이너 안의 경로입니다. 위 .env에서 붙인 디렉터리가 /keys이므로 보통 /keys/sa.json이 됩니다. 키 내용은 DB에 저장하지 않습니다.

대신 조회할 관리자 계정

디렉터리 API는 사람 자격으로만 답합니다. 서비스 계정이 이 관리자를 대신해 조직도를 읽습니다.

3 gcgos를 쓸 사람 고르기 조직도에서 교직원 조직 단위만 체크합니다.

이 화면에서 할 일

구글 조직도 불러오기를 누릅니다. 명단만 읽어 오고 계정은 만들지도 지우지도 않습니다.
표에서 교직원 조직 단위만 체크합니다. 상위를 고르면 그 아래는 전부 포함됩니다.
표 아래 상자에 몇 명이 계정을 갖게 되는지 바로 나옵니다. 그 숫자를 확인하고 저장하세요.

전교생이 워크스페이스에 있습니다. 교직원 조직 단위만 지정하세요. 비워 두면 아무도 계정을 갖지 못합니다 — 실수로 전교생에게 계정이 생기는 것보다 아무도 못 들어오는 쪽이 낫기 때문입니다.

명단만 읽어 옵니다. 계정은 만들지도 지우지도 않습니다.

상위 단위를 고르면 그 아래는 전부 포함됩니다. 이미 포함된 하위 단위는 체크가 잠긴 채 상위 포함으로 표시됩니다.

조직 단위	인원	gcgos 사용	학생

직접 입력 · 개별 예외 (고급)

교직원 조직 단위 (한 줄에 하나)

학생 조직 단위 (분류용, 계정 없음)

개별 허용 (조직 단위 밖의 예외)

개별 차단 (무엇보다 우선)

4 계정에 반영하기 고른 범위대로 gcgos 계정을 만들고 정리합니다.

이 화면에서 할 일

미리보기로 무엇이 바뀌는지 목록을 먼저 봅니다. 아무것도 바꾸지 않습니다.
목록이 예상과 같으면 동기화 실행을 누릅니다.
확인 필요로 남은 줄은 사람이 판단해야 하는 것들입니다 — 같은 사람인지 증거가 없는 계정, 명단에서 사라진 관리자.

안전장치: 관리 중인 계정을 한꺼번에 많이(30% 이상) 비활성화하는 동기화는 자동으로 막습니다. 관리자 계정은 어떤 경우에도 조용히 내려가지 않고 확인 필요로 남습니다.

계정도 함께 반영 (끄면 조직도만 갱신)

클래스룸 캐시

평소에는 서버가 하루에 한 번 알아서 다시 받습니다. 수업 목록이 하루를 넘기면 새로 받고, 오래된 명단은 조금씩 채웁니다. 아래 버튼은 그걸 기다리지 않고 지금 통째로 받는 것입니다.

수업 하나에 구글 호출 하나입니다. 수업이 많으면 몇 분 걸립니다.

내 페이지

내 계정과 이 계정으로 한 일을 봅니다.

내 정보

비밀번호 변경

바꾸면 다른 기기에 남아 있던 로그인은 모두 끊깁니다. 지금 이 화면은 그대로입니다.

PIN

신뢰 기기에서 비밀번호 대신 쓰는 4~6자리 숫자입니다. PIN은 신뢰 기기 쿠키가 있어야만 통하고, 여러 번 틀리면 그 기기가 잠깁니다.

내 신뢰 기기

PIN으로 로그인할 수 있는 브라우저입니다. 쓰지 않는 기기는 해제하세요 — 해제하면 그 기기에서는 다시 비밀번호로 로그인해야 합니다.

내 기록

이 계정으로 gcgos에서 한 일입니다. Argos에는 학교 공용 계정 하나로만 찍히므로, 누가 했는지가 남는 곳은 여기뿐입니다.

예약

학교 전체가 함께 보는 목록입니다. 취소는 예약을 건 사람과 관리자만 할 수 있습니다.

선택 0대

	이름	조직	그룹	플랫폼	시리얼	상태	현재 정책

정책 배포

플랫폼 정책 (클릭해서 선택)

안정적인 배포

선택: 0대

단말 명령

선택한 단말에 보냅니다.

동기화: 단말 정보를 Argos로 끌어옵니다(단말 변경 없음). 푸시: 잠든 단말을 깨워 대기 중인 정책을 즉시 적용하게 합니다.

단말 상태를 바꾸는 명령

안정적인 배포

단말 목록 갱신

Argos(MDM) 쪽 장애입니다

아이디 추가

앱 편집

gcgos 로그인

–

비밀번호 변경

PIN 설정

홈

홈

앱스

배포할 앱

대상 단말

퀵 그룹

클래스룸

MDM 계정 (Argos 공용 계정)

학교 (컴시간)

AI 도우미 (Claude)

비밀 저장 방식

구글 연동

구글 워크스페이스

구글 클라우드 콘솔에서 할 일

콘솔 두 곳에서 할 일

이 화면에서 할 일

이 화면에서 할 일

구글 워크스페이스

클래스룸 캐시

내 페이지

내 정보

비밀번호 변경

PIN

내 신뢰 기기

내 기록

예약

새 예약

정책 배포

단말 명령