Login

The block used to log an individual in to your mobile application.

The purpose of this block is pretty obvious, but in case you are unsure, it is to log a registered individual into your application using a Rock credential.

If you need to set up registration, check out the Register or Onboard Person blocks.

Login Page App Setting

When you create an instance of the Login block, it would be a good idea to also set the Login Page application setting. This allows the app to perform auto-security redirects and is used in a couple of other places functionally.

Settings

PropertyDescription

Registration Page

The mobile page to open when the Register button is tapped. Leave this option blank if you want to hide the Register button.

Forgot Password URL

The URL that is opened in an external browser when the Forgot Password button is pressed. Leave this option blank if you want to hide the forgot password button. This URL is typically [[ YourRootDomain ]]/ForgotUserName

Confirmation Page

Set to a web page on your public site that has been configured to handle account confirmation. If this option is left unset, it will not send the communication configured to confirm an account. External Homepage > Support Pages > Account Confirmation

Confirm Account Template

Set to the communication template you wish to use when an individual needs to confirm their account. If the Confirmation Page is not set, this communication will not be delivered.

The page to return to after an individual has successfully logged in. If this is not set, it will default to the Home page.

The page to return to after tapping the Cancel button. If this is not set, it will default to the Home page.

Page Parameters

The following page parameters are recognized by the Login block.

KeyTypeDescription

ReturnPage

Guid

The page to show once login has successfully completed. Takes precedence over the block setting.

External Authentication

Listed below is the corresponding documentation for every external authentication provider that can be integrated with Rock Mobile.

pageUsing Auth0pageUsing Entra

If/when more are added, corresponding documentation will be added to this section.

When considering integration with external authentication, be mindful of the UX change for your users. Rock uses credentials (username and password) to log people in. In many cases, people enter their email address as their username and likely assume the login is directly linked to that email, but it is not. This changes when external authentication is used.

External authentication is typically linked to another account that is directly tied to an email. If this is an email address shared between family members, a person match will not occur, and a duplicate will be created. Individuals will not be able to share an email in this way.

Last updated

⚙️ Powered by Rock RMS