🔑외부 서비스 키 설정 가이드

구글·카카오 로그인, 카카오 지도, 주보 추출 AI를 켜려면 각 회사에 “우리 본당 사이트가 이 기능을 쓰겠다”고 등록하고, 그때 받는 코드(키)를 관리자 화면에 붙여넣어야 합니다. 이 문서는 그 과정을 처음 해보는 분도 따라올 수 있게 클릭 순서대로 풀어 썼습니다.

목차

• 0 · 시작하기 전에 (공통)
• 1 · 구글 로그인 버튼 만들기
• 2 · 카카오 로그인 버튼 만들기
• 3 · 카카오 지도 띄우기
• 4 · 주보 추출 AI
• ★ 한눈에 보기
• ? 안 될 때 점검표

0 · 시작하기 전에 (공통)

“키”가 뭔가요?

구글·카카오·AWS 같은 외부 회사에 우리 사이트를 등록하면, 그 회사가 “이 사이트가 맞다”는 걸 알아보는 비밀번호 같은 코드를 줍니다. 이걸 키(key)라고 부릅니다. 우리는 그 코드를 받아서 관리자 화면에 붙여넣기만 하면 됩니다.

받은 키는 어디에 넣나요?

1. 1관리자로 로그인한 뒤, 왼쪽 메뉴에서 시스템 › 사이트 설정으로 들어갑니다. 이 페이지는 최고 관리자(슈퍼관리자)에게만 보입니다. 일반 관리자에게는 안 보이니 권한을 먼저 확인하세요.
2. 2설정은 묶음(그룹)으로 나뉘어 있습니다. 구글·카카오 로그인 + 카카오 지도는 OAuth 묶음, 주보 추출 AI는 AI 묶음입니다.
3. 3값을 넣고 각 칸의 저장 버튼을 누릅니다. 비밀 값은 저장하면 화면에 **** 로 가려져 보입니다(정상입니다).

저장하면 바로 되나요?

• 로그인(구글·카카오): 최대 약 1분 뒤에 반영됩니다.
• 카카오 지도: 최대 약 5분 뒤에 반영됩니다.

“서버 재시작 필요”라는 경고가 떠도 당황하지 마세요. 잠시 기다리면 적용됩니다. 더 빨리 반영하고 싶으면 운영(IT) 담당자에게 백엔드 서비스만 재시작해 달라고 요청하면 됩니다(컴퓨터 전체 재부팅이 아닙니다).

1 · 구글 로그인 버튼 만들기

로그인 화면에 “구글로 로그인” 버튼이 생깁니다.

• 준비물: 구글 계정
• 걸리는 시간: 10~15분

따라 하기 (구글 클라우드 콘솔)

1. 1console.cloud.google.com 에 접속해 구글 계정으로 로그인합니다.
2. 2화면 위쪽의 프로젝트 선택을 눌러 새 프로젝트를 만듭니다. 프로젝트 이름(예: 본당명)을 적고 만들기 → 만들어진 프로젝트를 선택합니다. “프로젝트”는 그냥 이 작업을 담아둘 폴더라고 생각하면 됩니다.
3. 3메뉴에서 API 및 서비스 › OAuth 동의 화면을 먼저 설정합니다. (처음에는 “동의 화면을 먼저 구성하라”는 안내가 뜹니다. 안내대로 진행하면 됩니다.) 시작하기 → 앱 이름(본당명)·지원 이메일 입력, 사용자 유형은 외부(External) 선택, 마지막에 게시 상태를 “프로덕션”으로 게시(테스트 상태로 두면 미리 등록한 사람만 로그인됩니다).
4. 4이제 사용자 인증 정보 › 사용자 인증 정보 만들기 › OAuth 클라이언트 ID 를 누릅니다. 애플리케이션 유형은 웹 애플리케이션을 고르고, 이름을 적습니다.
5. 5승인된 리디렉션 URI 칸에 https://우리도메인/api/auth/callback/google 을 글자 하나 틀리지 않게 그대로 넣고 저장합니다. “우리도메인” 부분만 실제 사이트 주소로 바꾸세요(예: our-parish.org).
6. 6저장이 끝나면 클라이언트 ID 와 클라이언트 보안 비밀번호, 이렇게 두 개의 값이 나옵니다. 둘 다 복사해 둡니다. (외부에 절대 노출 금지)

관리자 화면 OAuth 묶음에 붙여넣기

두 칸을 모두 채워야 “구글로 로그인” 버튼이 켜집니다.

2 · 카카오 로그인 버튼 만들기

로그인 화면에 “카카오로 로그인” 버튼이 생깁니다.

• 준비물: 카카오 계정
• 걸리는 시간: 10~20분

따라 하기 (카카오 개발자 사이트)

1. 1developers.kakao.com 에 접속해 카카오 계정으로 로그인합니다. 내 애플리케이션 › 애플리케이션 추가하기로 앱을 새로 만듭니다.
2. 2앱 이름(본당명)·회사명(본당/단체명)·카테고리를 입력하고 저장합니다. (대표 이미지 등은 안 넣어도 됩니다.)
3. 3만든 앱을 누르고 플랫폼(웹)에 우리 사이트 주소를 등록합니다: https://우리도메인
4. 4카카오 로그인 메뉴에서 활성화 상태를 ON 으로 바꿉니다.
5. 5Redirect URI(리다이렉트 주소) 칸에 https://우리도메인/api/auth/callback/kakao 를 그대로 넣습니다. “우리도메인” 부분만 실제 사이트 주소로 바꾸세요.
6. 6동의항목에서 로그인 때 받아올 정보를 켭니다: 닉네임, 프로필 사진. 이메일도 받고 싶다면 이메일 항목을 켭니다. 단, 이메일은 카카오 심사(비즈니스 앱 전환)가 필요할 수 있어 바로 안 될 수 있습니다. 심사 전에는 “선택 동의”로 동작합니다.
7. 7마지막으로 키 두 가지를 확인합니다. REST API 키 — 로그인에 쓰는 키. 보안 메뉴의 Client Secret — 발급(ON)해서 값을 확보. (두 값 모두 외부 노출 금지)

관리자 화면 OAuth 묶음에 붙여넣기

3 · 카카오 지도 띄우기

오시는 길·성당 소개 페이지에 위치 지도가 표시됩니다.

• 준비물: 카카오 계정
• 팁: 로그인과 같은 앱 재사용 가능

따라 하기 (카카오 개발자 사이트)

1. 1카카오 개발자 사이트의 앱 목록으로 갑니다. 2장에서 만든 로그인용 앱을 그대로 써도 되고, 새 앱을 만들어도 됩니다.
2. 2카카오맵 메뉴로 들어가 “사용 활성화”를 ON 으로 켭니다.
3. 3플랫폼 키 화면에서 JavaScript 키를 복사합니다.
4. 4같은 화면의 웹 도메인에 우리 사이트 주소를 등록합니다: https://우리도메인. JavaScript 키는 등록된 주소에서만 작동합니다. 테스트가 필요하면 http://localhost:3000 도 함께 등록하세요.

관리자 화면 OAuth 묶음에 붙여넣기

4 · 주보 추출 AI

주보 PDF를 올리면 공지·행사·모임을 자동으로 뽑아내 게시판·캘린더에 등록해 줍니다.

v3.1.0 이상키 하나로 켜는 아래 ①번 방법은 이 버전부터입니다. 그 전 버전은 ②번(AWS)만 됩니다.

① 키 하나로 켜기 (권장)

• 준비물: 이메일 주소와 신용카드
• 걸리는 시간: 10분 안팎

1. 1console.anthropic.com 에 들어가 계정을 만듭니다(구글 계정으로도 됩니다).
2. 2왼쪽 메뉴에서 Billing(결제)을 눌러 카드를 등록하고, 쓸 만큼 금액을 충전합니다. 처음에는 5달러 정도로 충분합니다.
3. 3왼쪽 메뉴에서 API keys를 누르고 [Create Key]로 키를 하나 만듭니다. 이름은 아무렇게나(예: 본당 홈페이지) 지으셔도 됩니다.
4. 4키가 화면에 한 번만 보입니다. 그 자리에서 복사해 두세요. 창을 닫으면 다시 볼 수 없고, 그때는 새로 만드시면 됩니다.
5. 5관리자 화면 시스템 › 사이트 설정 › AI 묶음의 「Anthropic API 키」 칸에 붙여넣고 저장합니다.

② AWS로 켜기 — 이미 AWS를 쓰고 계신 경우

• 준비물: AWS 계정
• 권장: IT 담당자 동행

AWS 쪽 큰 흐름 — 결국 값 3개를 얻는 게 목표

1. 1AI 모델 사용 신청. AWS 콘솔에서 Bedrock › Model access(모델 액세스)로 가서, 사용할 Claude 모델의 사용을 요청·승인받습니다. (이걸 안 하면 호출이 거부됩니다.)
2. 2전용 사용자 만들기. AWS의 IAM에서 사용자를 하나 만들고, 액세스 키를 발급받습니다.
3. 3그 과정에서 얻은 세 가지 값을 확보합니다: 리전(지역 코드), 액세스 키 ID, 시크릿 키.

관리자 화면 AI 묶음에 붙여넣기

AWS 쪽으로 켜실 때는 세 칸을 모두 채워야 합니다(하나라도 비면 켜지지 않습니다). ①번 방법으로 키 하나를 넣으셨다면 이 세 칸은 비워 두셔도 됩니다. 두 가지를 다 넣으시면 ①번 키가 쓰입니다.

기술 담당자용 참고 (모델 이름·권한 설정값)

비개발자라면 이 부분은 IT 담당자에게 그대로 전달하면 됩니다.

• AWS(②번)일 때 — 텍스트 분석 모델: global.anthropic.claude-haiku-4-5-20251001-v1:0
• AWS(②번)일 때 — 이미지(Vision) 분석 모델: global.anthropic.claude-sonnet-4-6
• global. 접두사는 교차 리전 추론 프로파일을 뜻합니다.
• Anthropic 직접 연결(①번)일 때는 같은 모델을 claude-haiku-4-5 · claude-sonnet-4-6 이라는 이름으로 부릅니다. 모델 승인 신청이나 리전 설정은 필요 없습니다.

IAM 사용자에게 최소한 bedrock:InvokeModel 권한이 필요합니다. 정책 예시: { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": ["bedrock:InvokeModel"], "Resource": "*" } ] }

교차 리전 프로파일을 쓰면 하위 리전 모델에 대한 InvokeModel 권한도 필요할 수 있고, 보안을 강화하려면 Resource를 해당 모델/프로파일 ARN으로 좁히는 것이 좋습니다.

★ 한눈에 보기

관리자 대시보드에서 각 기능의 켜짐/꺼짐 상태가 자동으로 표시됩니다. 값을 다 넣으면 “사용 가능”으로 바뀝니다.

? 안 될 때 점검표