애플리케이션 관리

모바일 앱과의 통합에 필요한 app_id와 secret_key를 생성할 수 있습니다.

대부분의 경우, 앱에는 하나의 앱 키만 필요하지만, 여러 앱을 제공하는 경우 각 앱에 대해 다른 앱 키를 생성하고 관리할 수 있습니다.

app_id와 secret_key는 SORI API 서버가 SDK를 인증하는 데 사용됩니다. 이것들은 비밀번호이므로 안전하게 보관하세요. 앱 키가 유출되었다고 의심되는 경우, SORI 콘솔에서 취소하고 다시 생성할 수 있습니다.

App ID & Secret Key 생성

App Key를 생성하려면 페이지 오른쪽 하단의 + 버튼을 클릭하세요.

각 앱 키를 식별할 이름을 입력하고 생성 버튼을 클릭하세요. 이제 목록에서 생성된 App ID와 Secret Key를 확인할 수 있습니다.

여러 앱을 운영하는 경우, 같은 방식으로 다른 앱 키를 생성할 수 있습니다.

예제 프로젝트 다운로드

App Key를 생성한 후에는 인증 정보를 직접 입력하지 않고, 바로 빌드할 수 있는 플랫폼별 예제 프로젝트를 다운로드할 수 있습니다.

APP Key 생성 날짜 오른쪽에 있는 ⁝를 클릭하고 코드 받기...를 선택하세요.

예제 프로젝트 다운로드 대화 상자에서 세 가지 플랫폼을 선택할 수 있습니다.

플랫폼	예제 프로젝트
Android	SORI Android Kotlin 예제
iOS	SORI iOS Swift 예제
Flutter	SORI 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를 삭제할 수 있습니다.