그누보드 기본 소셜로그인에 Apple 아이디로 로그인을 추가해 로그인, 회원가입, 기존 계정 연결·해제가 네이버·카카오와 같은 방식으로 동작합니다.
그누보드 코어와 테마·스킨 파일은 건드리지 않습니다.

그누보드5 / 영카트5 에서 사용할 수 있습니다. PHP 7.0 이상, 사이트 HTTPS 필수.

설치

1. 압축을 풀어 extend/kilho.social.php 와 plugin/kilho/ 폴더를 FTP 로 업로드합니다.
2. 관리자 환경설정 > 기본환경설정 의 소셜로그인 항목에 애플 아이디로 로그인 체크박스와 입력칸이 나타납니다.
3. Apple Developer 에서 아래 네 가지 값을 준비합니다.
   • Services ID: Identifiers 에서 Services ID 를 만들고 Sign in with Apple 을 켠 뒤 Configure 에서 사이트 도메인과 Return URL 을 등록합니다. Return URL 은 관리자 화면에 표시된 애플 Return URL 을 그대로 넣습니다.
   • Team ID: Apple Developer 계정 우측 상단의 10자리 값
   • Key ID · 개인키: Keys 에서 키를 만들고 Sign in with Apple 을 켠 뒤 .p8 파일을 내려받습니다. 이 파일은 한 번만 내려받을 수 있으니 보관하세요.
4. 관리자 화면에 Services ID, Team ID, Key ID 를 입력하고 .p8 파일을 메모장으로 열어 전체 내용을 개인키 칸에 붙여넣은 뒤 저장합니다. 개인키가 잘못되면 저장 시 경고가 뜹니다.
5. 로그아웃 후 로그인 페이지에 Apple 버튼이 보이면 설치 완료입니다.

기능

관리자 설정

• 애플 체크박스: 그누보드 소셜로그인 사용 목록에 Apple 을 추가·제외
• Services ID · Team ID · Key ID · 개인키: 저장 시 형식과 키 서명을 검사해 잘못된 값이면 경고
• 개인키: 저장 후 화면에 다시 표시하지 않음. 비워두고 저장하면 기존 키 유지
• Return URL: Apple Developer 에 등록할 주소를 화면에 표시
• 버튼 표시 조건: 소셜로그인 사용 + 애플 체크 + 네 가지 값 모두 입력. 하나라도 비면 버튼이 나오지 않음

로그인

• 로그인 페이지 소셜 버튼 목록에 Apple 버튼 추가. PC 는 새창, 모바일은 같은 창에서 진행
• Apple 로 가입한 회원은 바로 로그인 → 처음이면 그누보드 소셜 가입 화면으로 이동

회원가입

• 이메일·이름: Apple 에서 받아 가입 폼에 자동 입력
• 이메일 가리기: 사용자가 선택하면 Apple 중계 주소(@privaterelay.appleid.com)가 들어오며, 사이트에서 보낸 메일은 Apple 이 실제 주소로 전달
• 이름 보관: Apple 은 이름을 첫 승인 때만 보내므로 가입 도중 중단하고 다시 시도해도 채워지도록 30일간 보관. 플러그인 설치 전에 이미 승인한 사용자는 Apple 계정 설정 > 로그인 및 보안 > Apple 로 로그인 에서 사이트를 삭제한 뒤 다시 로그인하면 이름이 다시 옴

회원정보 수정 · 계정 연결·해제

• SNS 로그인 관리 목록에 Apple 추가: 기존 회원이 Apple 계정을 연결하거나 해제
• 비밀번호 확인: Apple 로 가입한 회원은 비밀번호가 없으므로 네이버·카카오 회원과 같이 확인 단계 없이 수정 페이지로 이동

동작 방식

• 그누보드 소셜로그인 엔진에 Apple 을 외부 프로바이더로 등록합니다.
• 로그인·가입·연결 처리는 그누보드 코어가 그대로 담당합니다.
• 버튼 모양은 스킨의 옆 소셜 버튼을 그대로 따라가고 색만 흰색 바탕에 검정 로고·테두리로 고정합니다.