처음 한 번
🔑외부 서비스 키 설정 가이드
구글·카카오 로그인, 카카오 지도, 주보 추출 AI 를 켜는 순서입니다. 각 회사에서 키를 받아 관리 화면에 붙여넣으면 끝납니다.
마지막 업데이트 2026-08-10
이 설명서의 표기
[ ] 는 눌러야 하는 단추, 「 」 는 적거나 고르는 칸입니다. › 는 화면을 찾아가는 길입니다.
구글·카카오·Anthropic 같은 회사에 “우리 본당 사이트가 이 기능을 쓰겠다”고 등록하면, 그 회사가 우리 사이트를 알아보는 비밀번호 같은 코드를 줍니다. 이것을 키라고 부릅니다. 받은 키를 관리 화면에 붙여넣으면 그 기능이 켜집니다.
전부 선택입니다
이 기능들을 켜지 않으셔도 게시판·캘린더·주보 올리기는 그대로 됩니다. 한 번만 하면 되고, 급하지 않으시면 나중에 하셔도 됩니다.
0 · 시작하기 전에
먼저 사이트 주소부터 확인하십시오
로그인 기능은 사이트 주소가 정확해야 됩니다. [시스템 › 사이트 설정]의 「사이트」 묶음에 있는 주소가 실제 운영 주소(예: https://our-parish.org)여야 합니다. localhost 로 되어 있으면 로그인이 깨집니다. 키를 넣기 전에 이것부터 보십시오.
여는 곳관리자 화면 › 시스템 › 사이트 설정
- 1왼쪽 메뉴에서 [시스템] › [사이트 설정]을 엽니다.최고관리자와 홈페이지 매니저에게만 보입니다.
- 2받은 키를 해당 묶음의 칸에 붙여넣습니다.구글·카카오 로그인과 카카오 지도는 「OAuth」 묶음, 주보 AI 는 「AI」 묶음입니다.
- 3그 칸의 [저장]을 누릅니다.저장하면 화면에 **** 로 가려집니다. 정상입니다.
다 되면로그인 키는 1분쯤, 카카오 지도 키는 5분쯤 뒤에 반영됩니다.
“서버 재시작 필요” 경고가 떠도 됩니다
잠시 기다리시면 적용됩니다. 더 빨리 반영하시려면 설치를 도와드린 담당자에게 백엔드만 다시 켜 달라고 하시면 됩니다. 컴퓨터 전체를 껐다 켜는 것이 아닙니다.
받은 키는 비밀번호와 같습니다
화면 공유·사진·단톡방에 그대로 나가지 않도록 조심하십시오.
1 · 구글 로그인 켜기
로그인 화면에 「구글로 로그인」 단추가 생깁니다. 구글 계정이 있어야 하고 10~15분쯤 걸립니다.
여는 곳구글 클라우드 콘솔 (console.cloud.google.com)
- 1구글 계정으로 로그인합니다.
- 2화면 위쪽 프로젝트 선택을 눌러 새 프로젝트를 만듭니다.이름은 본당명으로 하시면 됩니다. 프로젝트는 이 작업을 담아 두는 폴더라고 보시면 됩니다.
- 3[API 및 서비스] › [OAuth 동의 화면]을 먼저 설정합니다.앱 이름(본당명)과 지원 이메일을 넣고, 사용자 유형은 [외부]를 고릅니다.
- 4마지막에 게시 상태를 [프로덕션]으로 게시합니다.테스트 상태로 두면 미리 등록한 사람만 로그인됩니다.
- 5[사용자 인증 정보] › [사용자 인증 정보 만들기] › [OAuth 클라이언트 ID]를 누릅니다.애플리케이션 유형은 [웹 애플리케이션]을 고릅니다.
- 6「승인된 리디렉션 URI」에 https://우리도메인/api/auth/callback/google 을 넣습니다.우리도메인 부분만 실제 주소로 바꾸시고, 나머지는 글자 하나 틀리지 않게 그대로 넣습니다.
- 7저장하면 나오는 클라이언트 ID 와 클라이언트 보안 비밀번호를 복사해 둡니다.
다 되면
여는 곳관리자 화면 › 시스템 › 사이트 설정 › 「OAuth」 묶음
- 1「Google 클라이언트 ID」에 클라이언트 ID 를 붙여넣고 [저장]을 누릅니다.
- 2「Google 클라이언트 시크릿」에 보안 비밀번호를 붙여넣고 [저장]을 누릅니다.
다 되면1분쯤 뒤 로그인 화면에 「구글로 로그인」 단추가 나옵니다. 두 칸을 다 채우셔야 켜집니다.
2 · 카카오 로그인 켜기
로그인 화면에 「카카오로 로그인」 단추가 생깁니다. 카카오 계정이 있어야 하고 10~20분쯤 걸립니다.
여는 곳카카오 개발자 사이트 (developers.kakao.com)
- 1카카오 계정으로 로그인하고 [내 애플리케이션] › [애플리케이션 추가하기]를 누릅니다.
- 2앱 이름(본당명)·회사명·카테고리를 넣고 저장합니다.대표 이미지 같은 것은 넣지 않으셔도 됩니다.
- 3만든 앱을 누르고 플랫폼(웹)에 우리 사이트 주소를 등록합니다.https://우리도메인 형태로 넣습니다.
- 4[카카오 로그인] 메뉴에서 활성화를 ON 으로 바꿉니다.
- 5「Redirect URI」에 https://우리도메인/api/auth/callback/kakao 를 넣습니다.우리도메인 부분만 실제 주소로 바꿉니다.
- 6[동의항목]에서 닉네임과 프로필 사진을 켭니다.이메일도 받으시려면 이메일 항목을 켜십시오. 다만 이메일은 카카오 심사가 필요해 바로 안 될 수 있고, 심사 전에는 선택 동의로 동작합니다.
- 7「REST API 키」를 복사하고, [보안] 메뉴에서 「Client Secret」을 발급받아 복사합니다.
다 되면값 두 개를 손에 넣으셨습니다.
여는 곳관리자 화면 › 시스템 › 사이트 설정 › 「OAuth」 묶음
- 1「카카오 클라이언트 ID」에 REST API 키를 붙여넣고 [저장]을 누릅니다.
- 2「카카오 클라이언트 시크릿」에 Client Secret 을 붙여넣고 [저장]을 누릅니다.
다 되면1분쯤 뒤 로그인 화면에 「카카오로 로그인」 단추가 나옵니다.
로그인에 넣는 것은 REST API 키입니다
다음 장의 지도에서 쓰는 JavaScript 키와는 다른 키입니다. 두 키 모두 같은 카카오 앱 하나에서 나오므로, 한 앱으로 로그인과 지도를 함께 쓰실 수 있습니다.
카카오 개발자 사이트는 화면이 종종 바뀝니다
메뉴 자리가 이 설명과 조금 달라도 메뉴 이름으로 찾으시면 됩니다.
3 · 카카오 지도 켜기
오시는 길과 성당 안내 화면에 지도가 나옵니다. 2장에서 만든 앱을 그대로 쓰셔도 됩니다.
여는 곳카카오 개발자 사이트 (developers.kakao.com)
- 1앱 목록에서 쓰실 앱을 엽니다.
- 2[카카오맵] 메뉴에서 사용 활성화를 ON 으로 켭니다.가장 자주 빠뜨리는 곳입니다. 이것을 안 켜시면 키가 맞아도 지도가 뜨지 않습니다.
- 3플랫폼 키 화면에서 「JavaScript 키」를 복사합니다.
- 4같은 화면의 웹 도메인에 우리 사이트 주소를 등록합니다.JavaScript 키는 등록된 주소에서만 됩니다.
다 되면값 하나를 손에 넣으셨습니다.
여는 곳관리자 화면 › 시스템 › 사이트 설정 › 「OAuth」 묶음
- 1「카카오맵 JavaScript 키」에 붙여넣고 [저장]을 누릅니다.
- 2본당 정보 › 기본 정보에서 위도·경도를 넣었는지 확인합니다.키와 좌표 둘 다 있어야 지도가 뜹니다.
다 되면5분쯤 뒤 오시는 길 화면에 지도가 나옵니다.
4 · 주보 추출 AI 켜기
주보 PDF 를 올리면 공지·행사·모임을 저절로 뽑아 게시판과 캘린더에 넣어 줍니다. 켜는 방법이 두 가지인데 하나만 하시면 됩니다.
v3.1.0 이상키 하나로 켜는 아래 방법은 이 버전부터입니다. 그 전 버전은 AWS 만 됩니다.
4-1 · 키 하나로 켜기 (권장)
이메일 주소와 신용카드가 있으면 10분 안팎으로 끝납니다.
여는 곳Anthropic 콘솔 (console.anthropic.com)
- 1계정을 만듭니다. 구글 계정으로도 됩니다.
- 2왼쪽 [Billing]에서 카드를 등록하고 금액을 충전합니다.처음에는 5달러 정도면 넉넉합니다.
- 3왼쪽 [API keys]에서 [Create Key]를 누릅니다.이름은 아무렇게나 지으셔도 됩니다.
- 4화면에 뜬 키를 그 자리에서 복사해 둡니다.한 번만 보입니다. 창을 닫으면 다시 볼 수 없고, 그때는 새로 만드시면 됩니다.
다 되면키 하나를 손에 넣으셨습니다.
여는 곳관리자 화면 › 시스템 › 사이트 설정 › 「AI」 묶음
- 1「Anthropic API 키」에 붙여넣고 [저장]을 누릅니다.
- 2시스템 › 서버 진단에서 「주보 AI 분석」 줄을 봅니다.「설정됨 (직접 연결)」로 나오면 켜진 것입니다.
다 되면주보를 올리시면 자동 추출이 됩니다. 아래 AWS 칸 세 개는 비워 두셔도 됩니다.
4-2 · AWS 로 켜기
이미 AWS 로 쓰고 계시다면 그대로 두십시오
종전부터 AWS 값 세 개를 넣어 쓰고 계셨다면 아무것도 하지 않으셔도 그대로 됩니다. 아래는 새로 AWS 쪽으로 켜시려는 분을 위한 것입니다. AWS 콘솔이 복잡해서 처음 보시는 분이 혼자 끝내기는 쉽지 않습니다 — AWS 를 다뤄 본 분과 함께 하시길 권합니다.
여는 곳AWS 콘솔
- 1[Bedrock] › [Model access]에서 쓸 Claude 모델의 사용을 신청해 승인받습니다.이것을 안 하시면 호출이 거부됩니다.
- 2[IAM]에서 사용자를 하나 만들고 액세스 키를 발급받습니다.
- 3리전(지역 코드)·액세스 키 ID·시크릿 키 세 가지를 확보합니다.
다 되면값 세 개를 손에 넣으셨습니다.
여는 곳관리자 화면 › 시스템 › 사이트 설정 › 「AI」 묶음
- 1「AWS 리전」에 지역 코드를 넣고 [저장]을 누릅니다.예: us-east-1, ap-northeast-1
- 2「AWS 액세스 키 ID」를 넣고 [저장]을 누릅니다.
- 3「AWS 시크릿 키」를 넣고 [저장]을 누릅니다.
다 되면세 칸을 모두 채우셔야 켜집니다. 4-1 의 키를 넣으셨다면 이 세 칸은 비워 두셔도 됩니다. 둘 다 넣으시면 4-1 의 키가 쓰입니다.
지역이 같아야 합니다
모델을 켠 지역과 「AWS 리전」에 적는 값이 똑같아야 합니다. 다르면 되지 않습니다.
기술 담당자용 참고
AWS 텍스트 분석 모델은 global.anthropic.claude-haiku-4-5-20251001-v1:0, 이미지 분석 모델은 global.anthropic.claude-sonnet-4-6 입니다(global. 은 교차 리전 추론 프로파일). 직접 연결일 때는 같은 모델을 claude-haiku-4-5 · claude-sonnet-4-6 으로 부르며 모델 승인이나 리전 설정이 필요 없습니다. IAM 사용자에게는 최소한 bedrock:InvokeModel 권한이 있어야 합니다.
5 · 한눈에 보기
| 켜고 싶은 것 | 어디서 받나 | 넣는 값 | 묶음 |
|---|---|---|---|
| 구글 로그인 | 구글 클라우드 콘솔 | 클라이언트 ID + 보안 비밀번호 | OAuth |
| 카카오 로그인 | 카카오 개발자 사이트 | REST API 키 + Client Secret | OAuth |
| 카카오 지도 | 카카오 개발자 사이트 | JavaScript 키 + 카카오맵 활성화 | OAuth |
| 주보 추출 AI | Anthropic 또는 AWS | Anthropic API 키 하나 — 또는 리전·액세스 키 ID·시크릿 키 셋 | AI |
관리자 첫 화면에서 각 기능이 켜졌는지 꺼졌는지 볼 수 있습니다. 값을 다 넣으시면 「사용 가능」으로 바뀝니다.
안 될 때 보는 곳
| 이런 때 | 이렇게 보십시오 |
|---|---|
| 로그인 단추가 안 보임 | 그 서비스의 값 두 개를 다 넣으셨는지. 넣으셨으면 1분 기다리기 |
| 로그인을 누르면 오류가 남 | ① 사이트 주소가 실제 주소인지 ② 등록한 리디렉션 주소가 글자 하나까지 같은지 |
| 카카오 로그인은 되는데 이메일이 안 들어옴 | 카카오 동의항목에서 이메일을 켜셨는지, 심사 상태가 어떤지 |
| 지도가 안 뜸 | ① 카카오맵 활성화 ② JavaScript 키인지(REST 키 아님) ③ 도메인 등록 ④ 5분 기다리기 |
| 주보 자동 추출이 안 됨 | 시스템 › 서버 진단의 「주보 AI 분석」 줄부터 보십시오. 「미설정」이면 키가 안 들어간 것입니다. Anthropic 이면 결제 금액이 남았는지, AWS 면 값 셋을 다 넣으셨는지·모델 승인을 받으셨는지·지역이 같은지 |
막히셔도 됩니다
이 기능들은 전부 선택이고, 켜지 않으셔도 게시판·캘린더·주보 올리기는 그대로 됩니다. 어렵게 느껴지시면 도와줄 분과 함께 천천히 하십시오.