Ce chapitre n’est disponible qu’en coréen pour le moment.
TASTEGEO 는 기본이 거부입니다. 인증 방식을 하나도 정하지 않으면 서비스를 내지 않고, 설정이 모자라거나 서로 부딪치면 서버가 시작하지 않습니다.
아래 셋 가운데 하나만 씁니다. 서버 환경 파일(Windows config\server.env, Linux /etc/tastegeo/server.env)에 적고 서버 서비스를 다시 시작합니다.
| 환경 변수 | 권한 |
|---|---|
GEOSERVER_RS_BEARER_TOKEN | 읽기(reader) — WMS · WFS · WMTS · WCS 조회 |
GEOSERVER_RS_ADMIN_BEARER_TOKEN | 관리(administrator) — 쓰기 · REST |
설치할 때 두 토큰이 무작위로 만들어지고, 관리 화면은 관리 토큰으로 서버를 부릅니다. 요청에는 Authorization: Bearer <토큰> 머리글을 붙입니다.
GEOSERVER_RS_ALLOW_ANONYMOUS_READ=true — 로그인 없이 WMS · WFS · WMTS · WCS 를 읽기만 허용합니다. 쓰기와 REST 는 열지 않습니다.
토큰 방식과 함께 쓸 수 없습니다. 익명 읽기로 바꾸면 관리 화면이 서버를 관리할 수 없게 되므로, 공개 지도 서비스만 낼 때 쓰세요.
| 환경 변수 | 뜻 |
|---|---|
GEOSERVER_RS_BASIC_USER | 계정 이름 |
GEOSERVER_RS_BASIC_PASSWORD_HASH | Argon2id 해시(PHC 꼴) |
GEOSERVER_RS_BASIC_ROLES | reader, administrator 가운데(쉼표로) |
다섯 번 틀리면 5분 동안 잠깁니다. 비밀번호가 오가므로 HTTPS(TLS) 뒤에서만 쓰세요.
토큰이나 비밀번호를 바꾸면 서버를 다시 시작해야 반영됩니다.
관리 화면 계정은 하나입니다. 관리 화면 환경 파일(Windows config\admin.env, Linux /etc/tastegeo/admin.env)에 있습니다.
| 항목 | 뜻 |
|---|---|
TASTEGEO_ADMIN_USERNAME | 로그인 계정(기본 admin) |
TASTEGEO_ADMIN_PASSWORD_HASH | 비밀번호 해시(PBKDF2-SHA256) |
TASTEGEO_ADMIN_SESSION_SECRET | 로그인 세션을 잠그는 비밀 값 |
TASTEGEO_BASE_URL, TASTEGEO_AUTH_MODE, TASTEGEO_BEARER_TOKEN | 관리 화면이 서버를 부르는 주소 · 방식 · 토큰 |
TASTEGEO_ADMIN_SESSION_SECRET 에서 나오므로, 이 값을 바꾸면 저장된 연결의 비밀번호 · 토큰을 다시 넣어야 합니다.http://127.0.0.1:6740 이나 HTTPS 주소에서 여세요. 다른 컴퓨터에서 http:// 로 열면 로그인이 유지되지 않습니다.시스템 › 관리자 계정(오른쪽 위의 이름을 눌러도 됩니다)에서 지금 비밀번호와 새 비밀번호(두 번)를 넣고 비밀번호 바꾸기를 누릅니다. 비밀번호는 12~512자입니다. 바꾸면 다른 브라우저의 로그인은 끝나고, 이 브라우저는 그대로 씁니다.
바꾼 비밀번호의 해시는 admin.env 가 아니라 따로 둔 파일에 남습니다.
| 설치 | 파일 |
|---|---|
| Windows | %ProgramData%\tastegeo\state\admin-credentials |
| Linux | /var/lib/tastegeo/admin/credentials |
비밀번호를 잊었으면 이 파일을 지우고 관리 화면 서비스를 다시 시작합니다. admin.env 의 첫 비밀번호 (initial-admin-password 파일)로 돌아갑니다.
#### 도구로 바꾸기
화면을 쓸 수 없을 때는 함께 설치된 도구로 해시를 만들어 admin.env 를 바꿀 수도 있습니다(화면에서 바꾼 파일이 있으면 그 파일이 먼저이므로 함께 지우세요).
# Windows — 설치 폴더에서(Node.js 24)
node .\hash-admin-password.mjs# Linux(DEB)
/usr/lib/tastegeo/node/bin/node /usr/libexec/tastegeo/hash-admin-password.mjs비밀번호를 물으면 입력하고, 나온 pbkdf2-sha256$… 값을 TASTEGEO_ADMIN_PASSWORD_HASH 에 기존 줄과 같은 꼴(작은따옴표로 감쌈)로 바꿔 넣은 뒤 관리 화면 서비스를 다시 시작합니다.
429 로 잠시 거절합니다(상태 점검 제외).