アプリケーション管理

モバイルアプリとの統合に必要なapp_idとsecret_keyを作成できます。

ほとんどの場合、アプリには1つのアプリキーのみが必要ですが、複数のアプリを提供する場合は、各アプリ用に異なるアプリキーを作成して管理できます。

app_idとsecret_keyは、SORI APIサーバーがSDKを認証するために使用されます。これらはパスワードであるため、安全に保管してください。アプリキーが侵害された疑いがある場合は、SORI consoleで取り消して再作成できます。

App IDとSecret Keyの作成

[App Key](https://console.soriapi.com/account/application/)を作成するには、ページ右下の+をクリックします。

各App Keyを識別するための名前を入力し、作成をクリックしてください。 これで、作成されたApp IDとSecret Keyがリストに表示されるはずです。

複数のアプリを実行する場合は、同じ方法で異なるApp Keyを作成できます。

サンプルプロジェクトのダウンロード

App Keyを作成すると、認証情報を手作業で設定する代わりに、そのままビルドできるプラットフォーム別のサンプルプロジェクトをダウンロードできます。

APP Keyの作成日の右側にある⁝をクリックし、コードを取得...を選択します。

サンプルプロジェクトをダウンロードダイアログでは、3つのプラットフォームを選択できます。

プラットフォーム	サンプルプロジェクト
Android	SORI Example Android Kotlin
iOS	SORI Example iOS Swift
Flutter	SORI Example Flutter

プラットフォームを選択すると、SORI Consoleが対応する公開サンプルリポジトリからZIPファイルを生成します。このアプリケーションのapp_idとsecret_keyはすでに入力されているため、認証情報を手動で編集する必要はありません。

TIP

ファイルの生成には少し時間がかかります。ブラウザのダウンロードが開始されるまで、ダイアログを閉じないでください。

すべてのZIPファイルには、認証情報を含むファイルとプラットフォームごとの実行コマンドを記載したSORI_CREDENTIALS_NOTICE.mdが含まれています。

ダウンロードしたプロジェクトの実行

ZIPファイルを展開し、プロジェクトのルートディレクトリで実行してください。

Android — 認証情報はlocal.propertiesにSORI_APP_IDとSORI_SECRET_KEYとして書き込まれ、Gradleビルドがそれをアプリに渡します。

./gradlew installDebug

iOS — 認証情報はSORIExample/ContentView.swiftに設定されます。Xcodeでプロジェクトを開き、実機で実行してください。

open SORIExample.xcodeproj

Flutter — 認証情報はsori_credentials.jsonに書き込まれ、ビルド時に渡されるため、実行コマンドにこのファイルを含める必要があります。

flutter pub get
flutter run --dart-define-from-file=sori_credentials.json

WARNING

ダウンロードしたプロジェクトには、このアプリケーションのsecret_keyが含まれています。どのリポジトリにもコミットしたり、ZIPファイルをそのまま共有したりしないでください。Secret Keyが漏洩した場合は、該当のAPP Keyを削除して新しく作成してください。

統合の詳細については、Android、iOS、Flutterのガイドを参照してください。

App IDとSecret Keyの削除

APP IDとSECRET KEYが侵害された場合、アプリを取り消すことができます。

WARNING

削除後はこのアプリを復元できず、それを使用するSDKは動作しなくなることにご注意ください。

APP Keyの作成日の右側にある⁝をクリックして、APP Keyを削除できます。