Cotter
BlogDashboardGet help on Slack 👋
Search…
0.1.0
🚀
Getting Started
Features & Concepts
📌
Quickstart Guides
All Guides & Tutorials
HTML – Sign in with Email/Phone
React – Sign in with Email/Phone
React – WebAuthn
▲ Next.js
Angular
Webflow
Bubble.io
Python SDK for a CLI
React Native – Sign in with Device
iOS – Sign in with Device
Flutter – Sign in with Device
📘
SDK Reference
Web
React Native
Flutter
iOS
Android
Sign In with Device
Authenticate from a Non-Trusted Device
Check if Trusted Device is Enrolled
Add a new Trusted Device
Remove Trusted Device
Customization
Sign In with Email/Phone Number
Biometric/Pin
Older SDK Version
Python (for CLI)
API for Other Mobile Apps or CLI
Backend: Handling Response
🛡️ Protecting Your Account
Only Allow Your Website/App to Use Your API Key
Rate Limit
Enable reCAPTCHA to Protect Against Automated Abuse
🗝️ Getting Access Token
Cotter's OAuth 2.0 Tokens Specification
Getting the Tokens
Storing and Removing Tokens
Renewing Expired Tokens
Verifying JWT Tokens
Requesting Custom Fields on your JWT Token
Older API
🔌
API Reference
User API
OAuth Tokens API
OAuth Tokens from Social Login
Event Object
Reset PIN API
Older API
Validating Cotter's Identity Token
Validating Cotter's Event Response
Powered By GitBook
Customization
You can change the text and logo in most of the UI that's provided by Cotter's Android SDK.

Getting started

To start customizing the UI, you can copy and paste the code below and edit the text as you like.
Make sure to do Cotter.init before setting any of the UI customization

Approve Authentication Request Prompt

ApproveRequest page
To customize this page, do the following:
Cotter.strings.setApproveRequestStrings(Strings.Title, "ARE you trying to sign in?");
Cotter.strings.setApproveRequestStrings(Strings.Subtitle, "SOMEONE is trying to sign in to your account from another device.");
Cotter.strings.setApproveRequestStrings(Strings.ButtonYes, "YES");
Cotter.strings.setApproveRequestStrings(Strings.ButtonNo, "NO");
// To update the logo, add an image in your /res/drawable folder
Cotter.colors.setLogo(R.drawable.logo);

Request Authentication Prompt

RequestAuth prompt
To customize this prompt, do the following:
Cotter.strings.setRequestAuthStrings(Strings.DialogTitle, "APPROVE this login from your phone");
Cotter.strings.setRequestAuthStrings(Strings.DialogSubtitle, "A NOTIFICATION is sent to your trusted device to confirm it's you.");
Cotter.strings.setRequestAuthErrorStrings(Strings.DialogTitle, "SOMETHING went wrong");
Cotter.strings.setRequestAuthErrorStrings(Strings.DialogSubtitle, "WE'RE UNABLE to confirm that it's you. Please try again.");

QR Code Scanner Dialog

SuccessSheet dialog
To customize the text in this dialog, do the following:
Cotter.strings.setSuccessSheetStrings(Strings.DialogTitle, "SUCCESS Registering New Device");
Cotter.strings.setSuccessSheetStrings(Strings.DialogSubtitle, "YOU CAN now use your new device to access your account without approval.");
Cotter.strings.setSuccessSheetErrorStrings(Strings.DialogTitle, "UNABLE to Register New Device");
Cotter.strings.setSuccessSheetErrorStrings(Strings.DialogSubtitle, "PLEASE try again.");

Show QR Code Page

QRCodeShow page
To update this page, do the following:
Cotter.strings.setQRCodeShowStrings(Strings.Title, "REGISTER this Device");
Cotter.strings.setQRCodeShowStrings(Strings.Subtitle, "PLEASE scan this QR Code from a Trusted Device.");
Cotter.strings.setQRCodeShowErrorStrings(Strings.Title, "SOMETHING went wrong");
Cotter.strings.setQRCodeShowErrorStrings(Strings.Subtitle, "THE REQUEST timed out. Please try again.");
Previous
Remove Trusted Device
Next
Sign In with Email/Phone Number
Last modified 2yr ago
Copy link
Outline
Getting started
Approve Authentication Request Prompt
Request Authentication Prompt
QR Code Scanner Dialog
Show QR Code Page