Connected apps
A connected app is your own website or app. Members sign in to it with their Crewcade account. You add the app in Crewcade. Developers then build the sign-in. See Sign in with Crewcade.
Add an app
Section titled “Add an app”Club owners and admins can add apps. You need the Manage Integrations permission.
- Open Settings and choose Developers. Open the Connected apps tab.
- Click Add an app.
- Enter an App name. Add a Website (optional) if you have one.
- Choose the Type of app.
- Add your Return URLs.
- Click Add app.
Crewcade shows the Client ID. A server app also gets a Client secret.
Each app also shows a Sign-in settings URL. Give it to your developer with the client ID. Click Copy next to it.
There are two types of app:
- Website or mobile app. It runs in a browser or on a phone. It has no secret.
- Server app. It runs on your own server. It gets a secret.
Crewcade shows the secret once. Copy it right away and store it in a safe place. Never put it in a web page or a phone app.
Return URLs
Section titled “Return URLs”A return URL is where Crewcade sends the member after sign-in. Each address must match exactly.
- Use
https. - Use
httponly forlocalhost,127.0.0.1or[::1], while you test. - Do not add a
#part, a user name or a password. - Do not use
*. - Add up to 10 return URLs.
Turn off, replace the secret, delete
Section titled “Turn off, replace the secret, delete”- Turn off: Every member is signed out of that app. Members must approve the app again after you turn it on.
- Replace secret: The old secret stops working right away. Members are signed out. Your server needs the new secret.
- Delete: Members lose their connection to the app. The app stops working. You cannot undo this.
The club owner gets an email when someone adds an app. The owner also gets an email when someone replaces a secret.
What members see
Section titled “What members see”- A member taps Sign in with your club in your app.
- The member signs in on the page of your club. The member can use a password, Google or LINE. The member can also ask for a 6-digit email code. The code lasts 10 minutes.
- The member sees what your app can do. The screen asks to connect the app to the club account.
- The member taps Allow or Cancel.
Your app never sees the password of the member. Crewcade remembers the choice of the member. The member does not see the screen again.
A person who is not a member yet is asked to join your club first. A person who waits for approval cannot connect the app yet.
Members disconnect an app
Section titled “Members disconnect an app”Members see their connected apps in their account. They open Settings and choose Connected apps. A member can disconnect an app at any time. The app is signed out at once. The member must approve it again to use it again.
A suspended member is signed out of every app. A member who leaves the club is also signed out.