Kakao Developers
アプリ登録とキー発行
Kakaoログイン・マップ・アルリムトク・シェア等のKakao APIを利用するには、Kakao Developersにアプリを登録する必要があります。 アプリ作成からキー発行、プラットフォーム設定まで順を追って説明します。
登録料
無料
審査
即時
必要
Kakaoアカウント
Overview
開始前にご確認ください
Kakao Developersは無料で登録可能ですが、一部機能(Kakaoログイン同意項目・アルリムトク・ビズメッセージ)は追加申請・審査が必要です。アプリキーは絶対にクライアントに露出させないでください — Adminキーはサーバー専用です。
Kakaoアカウント準備
メール/携帯認証済みアカウントが必要。
サービスドメイン決定
Webサービスならドメインを先に確定。
プライバシーポリシーURL
Kakaoログイン審査に必須。
ビジネスアカウント(任意)
アルリムトク・ビズメッセージが必要な場合。
Step by Step
ステップ別ガイド
SIGNUP
Kakaoアカウント + 開発者登録
Kakao Developersにログインし、開発者として登録します。
- developers.kakao.comにアクセス → 右上ログイン
- 初回ログイン時に開発者利用規約に同意
- メール/携帯認証の完了が必須
CREATE APP
マイアプリケーション作成
アプリの基本情報を入力します。
- マイアプリケーション > アプリケーションを追加
- アプリアイコン(最小128×128、PNG推奨)
- アプリ名(KakaoTalkシェア・ログイン画面に表示)
- 事業者名 / カテゴリを選択
KEYS
アプリキー確認とセキュリティ
4種のアプリキーが自動発行されます。
- ネイティブアプリキー: iOS/Androidネイティブ SDKで使用
- JavaScriptキー: Web JS SDKで使用(ドメイン制限必須)
- REST APIキー: サーバーからのREST呼び出し
- Adminキー: ユーザー管理 API・クライアント露出厳禁
- キー漏洩時はアプリ設定から再発行可能
PLATFORM
プラットフォーム登録
アプリが動作するプラットフォーム情報を登録します。
- Android: パッケージ名 + キーハッシュ(keystore SHA1 → Base64)
- iOS: バンドルID登録
- Web: サイトドメイン(http://localhost含め複数可)
- 未登録のプラットフォームはSDK呼び出しが失敗
AUTH
Kakaoログイン有効化
Kakaoログインを使う場合は有効化とRedirect URI登録。
- 製品設定 > Kakaoログイン > 有効化 ON
- OpenID Connect有効化(JWTトークンが必要な場合)
- Redirect URI登録(Webのみ、ネイティブはアプリキー)
- 同意項目設定(ニックネーム・プロフィール・メール・年代等)
- 必須同意は審査が必要・任意同意は即時利用可能
REVIEW
同意項目の審査依頼(必要時)
メール・誕生日・性別など一部項目はビズアプリ転換後に審査が必要です。
- ビズアプリ転換: 事業者登録証アップロード
- プライバシーポリシーURL登録必須
- 審査項目: メール・誕生日・出生年・性別・連絡先・住所等
- 審査期間: 営業日1–5日
MESSAGE
KakaoTalkメッセージ / シェア
メッセージAPI設定。アルリムトクとは別。
- 製品設定 > KakaoTalkメッセージ > 有効化
- テンプレートビルダーでシェア/メッセージテンプレートを作成
- テンプレートIDでネイティブ/JS SDKから送信
- 実際の送信には受信者同意(talk_message)スコープが必要
ALIMTALK
アルリムトク(任意・別途申請)
アルリムトクはKakao Developersではなくビズメッセージプラットフォーム(NHN・Aligo等)経由で送信。
- Kakao Business > KakaoTalkチャンネル開設が先
- チャンネルのビズ認証完了
- NHN Cloud・Aligo・スイングファーム等の発送代行契約
- テンプレートはKakaoが直接審査(営業日1–2日)
- 件単価はおよそ8~10ウォン
Pitfalls
詰まりやすいポイント
キーハッシュ不一致(Android)
debug keystoreとrelease keystoreのSHA1は異なります。両方のハッシュを登録しないとリリースアプリでKakaoログインが動きません。
JavaScriptキーのドメイン制限未設定
全ドメイン許可のままだと他人にキーを盗まれる可能性があります。プラットフォーム > Webで許可ドメインを明示。
Adminキーのクライアント露出
GitHubパブリックリポジトリにAdminキーが上がる事故が頻発します。.envに分離しgitignoreを確認。
メールを未審査で必須同意
審査なしでメールを必須同意に設定するとログイン時にエラー。ビズアプリ転換+審査完了後に利用してください。
アルリムトクとフレンドトクの混同
アルリムトクは情報性(同意不要)・フレンドトクは広告性(チャンネル友だちのみ)。用途に合わせて選択。