Prerequisite Tasks
The following tasks must be completed before Aspenware can install the Identity v3 (Powered by Auth0) plugin. Please contact Aspenware Customer Success (support@aspenware.com) if you have any questions.
Hosting and Minimum Versions
To implement Identity v3 (Powered by Auth0), your resort must meet the following criteria:
Resort must be an Aspenware Cloud customer using the Aspenware Cloud hosting platform.
Resort must be on the following minimum versions or later:
Unity 3.47
Commerce 3.6
Accounts 1.8
Cloud UI 1.7
Arrival 1.10
Resort must have an active account with Auth0.
Auth0 Tasks
Please provide the following selections or information to Aspenware for configuration of your Identity v3 (Powered by Auth0) platform.
Description | Customer Value | |
What Resort is this tenant for? This will be used as the Resort “friendly name” that is in emails | Input your resort name: |
|
What sub-domain would you like to use? (If it’s the same as the current one, please list regardless). Example {domain}.ResortName.com YOU MUST CHOOSE A NEW SUB-DOMAIN NAME. We recommend ‘auth’ or ‘login.' | Please input the sub-domain for login and create account flows: |
|
Age Restriction (Will default to 13) | Please input the minimum age to create account: |
|
Password Strength * This is enforced for new account creation. Existing accounts will continue to work with previous password strength. | Please input your selection for password strength: |
|
Auth0 transactional emails include: Forgot passwords, customer verifications, and invitations.
*Commerce emails like order confirmations can still be sent via Inntopia or any other email provider you have. | SMTP Provider: |
|
From Email Address (used to send reset passwords, verifications, etc): |
| |
Tenant ID (MS365 only): |
| |
Client ID/Active Directory (MS365 only): |
| |
Client Secret/Active Directory (MS365 Only): |
| |
(SMTP) Host Name: |
| |
(SMTP) Port: |
| |
(SMTP) Username: |
| |
(SMTP) Password: |
| |
(SMTP) API Key: |
| |
For guests who need to troubleshoot account issues, please list a phone number (Customer Matching, etc.) for guests to call. | Phone: |
|
Tenant Support email: Can be used as a ‘variable’ in an email that is sent to guests from auth0 (password reset, verifications, etc.) | Email: |
|
Google Tag Manager ID (Login & Create Account Metrics). | GTM ID: |
|
Add marketing consent to create customer? | Input Yes or No: |
|
Account Lookup with Pass? | Input Yes or No: |
|
Create Account with Pass? | Input Yes or No: |
|
Do you have RTP Rewards Module? | Input Yes or No: |
|
Is this resort part of a multi-store environment? If so, please list all the resorts associated. | Input Yes or No: |
|
Please list your store URLs here: | ||
Do you have Aspenware Arrival? | Input Yes or No: |
|
Do you have 3rd party applications? If yes, fill out page 2 | Input Yes or No: |
|
3rd Party Applications
Resort completes the application section on the onboarding form below and sends to Aspenware.
Application Description
Application type
Callback URL
Logout URL
withScheme (recommended 'app')
Aspenware sets up Auth0 applications for the Resort 3rd party application.
Once application(s) are setup in Auth0 Tenant, Aspenware will provide resort with connection name and scope to put in their application(s) code-base.
Resort Dev team to setup application using Auth0 guidelines.
Resort Dev team to test.
Aspenware Dev to guide/assist during process.
Applications | |
|
|
1a. Android/iOS/Other |
|
1b. Callback URL |
|
1c. Logout URL |
|
1d. withScheme (We recommend ‘app’) |
|
Theming Tasks
If the resort is already on Identity, Aspenware can use the theming elements already provided. For a new implementation, please provide the following:
Theme Options | Customer Values | |
Resort Logo | Attach logo (logo scales) in email: |
|
Background Image or Color | Attach Image (1920x1080) or provide Color HEX: |
|
Favicon Image | Attach Favicon: |
|
Brand Font | Provide URL to Brand Font: |
|
Button Color | Provide Color Hex: |
|
Text Color | Provide Color Hex: |
|
Link Color | Provide Color Hex: |
|
Mask (overlay) Color | Provide Color Hex: |
|
Content & Language Strings
Auth0 Sign-in Screens | |||
Description | Language String | Default | Customer Request |
Title | title | None |
|
Description | description | None |
|
Email placeholder | emailPlaceolder |
| |
Account lookup link | var-passMediaLinkText | Lookup email by pass number |
|
Account lookup title | var-passMediaTitleText | Let’s lookup your account |
|
Lookup instruction | var-passMediaInstructionsText | Enter the number on your pass |
|
Pass number | passMediaFieldLabel | Pass Number |
|
Account lookup Success message | var-passMediaSuccessPrompt | An Account was found |
|
Account lookup success body | var-passMediaSuccessDescription | The email we have on file with this pass number is: |
|
Auth0 Sign-Up Screens | |||
Description | Language String | Default | Customer Request |
Title | title | None |
|
Description | description | None |
|
Email placeholder | emailPlaceolder |
| |
Yes/No for Pass | var-havePassTitle | Do you have a pass |
|
Instruction | var-passNumberTitle | Enter the number on your pass |
|
‘Pass number’ field placeholder | var-passMediaFieldLabel | Pass number |
|
Create account with pass error: | var-signupWithPassError | There was a problem creating your account. Please call resort ###-###-#### or create an account without a pass |
|
Receive updates and what’s new happening at {resort} | accounts.userprofile.receiveemailstext | Receive updates and what’s new happening at {resort} |
|
Customer matching | accounts.accountexists.subtitle | Call Resort to verify account Resort phone number: ###-###-#### |
|
Rewards Enrollment Consent | Accounts.UserProfile.CustomConsentDescription | This is a custom consent message with a link |
|
Aspenware Commerce Tasks
NOTE: Credentials will continue to be stored in RTP; Resort support staff can still adjust auth profile credentials.
Settings
Configuration | Description |
---|---|
customersettings.usernamesenabled | Must set to FALSE to disable usernames in Aspenware Commerce. |
customersettings.dateofbirthminimumage | Ability to set the age restriction for creating an account |
ordersettings.anonymouscheckoutbyproduct | Enables guest checkout to occur. |
checkout.guestcheckout.preferguest | Must be set to ‘true.' Enables guest to sign in as an option. |
auth0externalauthsettings.emailmarketingconsentenabled | Enable Email Marketing on create customer |
auth0externalauthsettings.customconsentenabled | Enables custom consent to be submitted by guest when completing customer profile (E.g. rewards enrollment) |
auth0externalauthsettings.customconsentdefaultvalue | Defaults consent checkbox to checked or unchecked |
Reporting via Google Analytics
Identify v3 (Powered by Auth0) includes robust Google Analytics tracking. The following events are included in the data layer.
Title | Description | Location | Type (Page/Event) |
---|---|---|---|
Sign-in Page | When a customer views sign in page | Auth0 | Page View |
Forgot password page | Customer view ‘forgot password’ page | Auth0 | Page View |
forgot_password_select | Customer selected ‘forgot password’ | Auth0 | Event |
forgot_password_submitted | Customer sent email to themselves to reset password | Auth0 | Event |
signin_attempt | Customer selects ‘continue’ from sign in | Auth0 | Event |
signin_error | Customer experiences a sign in error, such as password didn’t match, account exists, etc. | Auth0 | Event |
successful_login | Customer has been authenticated and directed to shop successfully | AW Cloud UI & Commerce | Event |
signup_selection | Customer selects ‘sign up’ in auth0 | Auth0 | Event |
Sign-up Page | Customer views sign up page | Auth0 | Page View |
signup_attempt | Customer selects ‘continue’ after input email/password when creating a new account | Auth0 | Event |
signup_success | Customer is successful in creating new account in auth0 | Auth0 | Event |
auth0_account_error | Error occurred during sign up in auth0 such as email in use, API error. | Auth0 | Event |
Customer profile page | Customer views create customer profile page | AW Cloud UI | Page View |
customer_match | Customer submits create profile and is matched to an existing customer in RTP (1 or many) | AW Cloud UI | Event |
Customer match (1) page | Customer views ‘verification needed’ page after match | AW Cloud UI | Page View |
Customer match (many) page | Customer view ‘call resort’ after being matched to multiple customers in RTP | AW Cloud UI | Page View |
create_profile | Customer is successful in creating new customer | AW Cloud UI | Event |
Update_Customer_Profile_Error | Customer experienced an error at creating a new customer | AW Cloud UI | Event |
account_lookup | Customer selects ‘look up account with pass’ | Auth0 | Event |
account_found | Customer inputs a valid pass and found an account | Auth0 | Event |
account_notfound | Customer input an invalid pass or no account found | Auth0 | Event |
signupwithpass_invitesent | Customer inputs correct pass, has email on file, and has no auth profile | Auth0 | Event |
Property: error_accountexists | Customer inputs a valid pass but account exists | Auth0 | Event |
Property: error_incorrectnumber | Customer inputs a invalid pass number and nothing found. | Auth0 | Event |
error_noemail | Customer inputs a valid pass but no email profile exists to verify | Auth0 | Event |
Add password | When a guest lands on the add password screen |
| Page View |
Implementation
Once Aspenware has received your onboarding information, they will send you a timeline for your implementation and be in contact as the process progresses.
Questions about Identity v3 (Powered by Auth)? Check out our Frequently Asked Questions page or contact your Aspenware Customer Success Representative.