You need Javascript enabled to view this page.

LaunchKey Setup Wizard

LaunchKey Settings

Restart Setup Wizard

Hi there. Let's get started.

You're just moments away from eliminating the hassle and risk of passwords from WordPress. This setup wizard will guide you through the setup and configuration process with LaunchKey.

If you haven't done so already, you'll need to install the FREE LaunchKey Mobile Authenticator on your smartphone or tablet. LaunchKey Mobile Authenticator is available in the Apple App Store or Google Play.

If you need help, or just want to learn more about the LaucnhKey Mobile Authenticator, check out our Mobile App Guide.

When you're ready to begin, click the button below.

Begin Setup

Configuration Method

Select the configuration method:

LaunchKey MFA

Use this wizard for configuring a standard multi-factor implementation. If you are not sure which option to choose, this is likely the correct option.

Start MFA Wizard

LaunchKey Single Sign On

Use this wizard if you are adding this site to your LaunchKey Single Sign On implementation.

Start SSO Wizard

Manual Configuration

Manually configure your site without any assistance from the Wizard.

Configure Manually

Easy Setup Check

Easy Setup is the quick and easy way to set up your WordPress site using the LaunchKey Mobile Authenticator. If your mobile device has Easy Setup, it is highly suggected you choose that optopin.

Easy Setup

This wizard require Easy Setup to be available on your device. If you have a menu item named Easy Setup in the main menu for the LaunchKey Mobile authenticator, you may select this option.

Easy Setup

Classic Wizard

Use this option if you do not have Easy Setup on your LaunchKey Mobile Authenticator or are having issues completing the setup with Easy Setup.

Classic Wizard Setup

Easy Setup Check

If you LaunchKey Mobile Authenticator has Easy Setup in the main menu, select the menu item and click Next; otherwise, No Easy Setup.

1. Click the Load button to generate the QR Code for the mobile device.

2. Scan the QR Code and follow the prompts. When that process is completed, click Next

Next

Next, log in to LaunchKey Dashboard

Follow these steps:

1. In a new browser tab or window, navigate to https://dashboard.launchkey.com

2. In the input field, enter the LaunchKey username you chose previously and press enter

3. An authorization request will be pushed to your mobile device. Approve the request within LaunchKey Mobile by sliding the LaunchKey icon up Details

With LaunchKey, instead of providing a website or application with a password for login, an authentication request is pushed to your mobile device for you to authorize through the LaunchKey mobile app. Once you authenticate and authorize the request through LaunchKey Mobile, you will be automatically logged in. You will use LaunchKey Mobile to log in to WordPress in the same manner.

For more details on how to use receive & respond to requests using LaunchKey Mobile, visit: https://docs.launchkey.com/user/mobile-app-guide/launch-requests.html

Next

Okay, let's create an Application for your WordPress site

To ensure your WordPress site can communicate with the LaunchKey service, you need to create a LaunchKey Application within Dashboard. An Application represents your WordPress site within LaunchKey, and it's where you can manage and configure the way your WordPress site interacts with the LaunchKey API and users, as well as where you'll find keys and other LaunchKey data.

Follow these steps:

1. Create a new Application by navigating to https://dashboard.launchkey.com/my/newapp

2. Choose a name, description, and avatar that represents this WordPress site. Details

This information will be visible to LaunchKey users anytime they receive a login request from your WordPress site. You can change these details at anytime.

Name - Enter a unique name that reflects the name or URL of this WordPress site

Description - (optional) Enter a brief description

Avatar - (optional) Upload a GIF, JPG, or PNG image that represents your WordPress site or branding

3. Submit the form by clicking the Create Application button. Details

Read and agree to the Developer Terms of Service, and then click Create Application to submit the form.

Once you've completed and submitted the form, click the Next button to move on.

Next

Add this Callback URL to your Application

View more information

Once a login authorization request has been sent to your user, your WordPress site will leverage a technology called Server Side Events to wait for an authorization response from your user. To do this, your Application will post resonses to your WordPress site using the Callback URL below. Add this URL to the configuration options of your Application. View less

Your Callback URL is:

%%%callback_url%%%

Follow these instructions:

1. If you're not already on the details page of your new Application, click on the menu icon within Dashboard, select Applications, and click on the name of the Application you just created.

2. In the General tab within the Configuration section, copy and paste the URL above into the input next to Callback URL.

Changes to your Application are saved automatically. Click Next to proceed.

Next

Almost done! Configure this plugin with keys from your Application

Follow these steps:

1. Click on the Keys tab within your Application details page inside Dashboard.

2. Copy the value next to Application Key and paste it in the corresponding input field below:

3. Under the Encryption Keys section, click the New Secret Key button and select the View & copy new key option from the dropdown menu. A new Secret Key will be generated and displayed in place of the button. Copy this new key and paste it in the corresponding input field below:

4. Also under the Encryption Keys section, click the New Private Key button and select the Download new key option from the dropdown menu. Your new Private Key will be saved to your computer in a file called LaunchKey.key. Upload the LaunchKey.key file here by clicking the button below:

After you've supplied the 3 keys needed above, click the Next button to save these keys and proceed.

Next

Finally, let's verify everything is working

In order to verify that your WordPress site can now initiate authorization requests using LaunchKey, initiate a request by entering your LaunchKey username below, click Verify, and authorize the request on your mobile device. An authorization request will be pushed to your mobile device containing the Application name, description, and avatar you chose earlier.

Processing

Congratulations! You have successfully configured the LaunchKey WordPress Plugin!

Finished!

Congrats, LaunchKey has been configured with your WordPress site.

To log in to WordPress with LaunchKey, simply submit the login form with your standard WordPress username, %%%wp_username%%%.

Setting Up Other Users

Other users of this WordPress site may activate LaunchKey by enabling LaunchKey within their WordPress profile section. Please notify them accordingly.

Until the remaining users of your WordPress site activate LaunchKey for their user account, they will need to click the Show Password Field link on the login form to enter the password for their user.

Click the Finish button below to proceed to the standard settings and configuration page.

Next, log in to LaunchKey Dashboard

Follow these steps:

1. In a new browser tab or window, navigate to https://dashboard.launchkey.com

2. In the input field, enter the LaunchKey username you chose previously and press enter

3. An authorization request will be pushed to your mobile device. Approve the request within LaunchKey Mobile by sliding the LaunchKey icon up Details

With LaunchKey, instead of providing a website or application with a password for login, an authentication request is pushed to your mobile device for you to authorize through the LaunchKey mobile app. Once you authenticate and authorize the request through LaunchKey Mobile, you will be automatically logged in. You will use LaunchKey Mobile to log in to WordPress in the same manner.

For more details on how to use receive & respond to requests using LaunchKey Mobile, visit: https://docs.launchkey.com/user/mobile-app-guide/launch-requests.html

< Choose a different option

PHP Extension Pre-Requisites

Okay, let's verify that your WordPress site has access to the required PHP extenstions

Your site has he required extensions. Press "Next" to continue...

Your site does not have the required extensions. Press "Back" to select another option...

Okay, let's create a Single Sign On profile for your WordPress site

A single Sign-On profile tells LaunchKey how to interact with your WordPress site.

Follow these steps:

1. Navigate to Organizations in the LaunchKey Dashboard.

2. Create a new Organization. Existing Organizations can skip to step 3. Details

Follow these steps to create a new Organization.

  1. Click on the New Organization button
  2. Enter the following data:
    • Organization Name - Unique name for your Organization. e.g LaunchKey WordPress
    • First Name - Your first name
    • Last Name - Your last name - Not required but strongly encouraged. Names are the only way for you to distinguish between individuals in your Organization.
    • Email Address - Your email address. This email address will be used for verifying the creation of this organization. It will be encrypted before being stored to protect your privacy.
  3. Click on the Create Organization button
  4. Open the "Create Organization" confirmation email and click the Create Organization button.
  5. Login to the LaunchKey Dashboard as instructed
  6. Verify that you are in the correct Organization after logging in
  7. Contact LaunchKey via Support to have Single Sign On enabled for your Organization. Single Sign On is a billable feature.

3. Add a Single Sign On Profile for your WordPress site. Details

Follow these steps to create a new Single Sign On profile.

  1. Click the New SSO button in the Single Sign On page of your Organization.
  2. Enter the following data into the Basic Information panel:
    • Profile Name - This is the name that a user will select from the Single Sign On page for your organization. it should be relatively short but distinguishable from other profiles in this Organization's Single Sign On.
    • Template - Choose LaunchKey WordPress
  3. Read the Developer Terms of Service and click the checkbox to agree.
  4. Click the Create SSO button.

4. Configure the SSO Profile for your WordPress site. Details

Follow these steps to configure the newly created Single Sign On profile for your WordPress site.

  1. Enter the following data into the Configuration panel of the General tab:
    • Entity ID - This is the unique identifier for this profile within your organization. A good option for the entity ID would be your site domain. Remember this value as it will be needed later when you configure WordPress for this SSO profile.
    • Post URL - Enter %%%sso_post_url%%%
  2. Verify the role that will be used when auto-creating users. If an Organization User that has been mapped in the Users tab that does not exist within WordPress logs in via SSO, a new user will be created with the mapped username and the role specified in the role attribute configured in the Attributes tab.

Once you've completed the Single Sign On profile, click the Next button to move on.

Okay, let's configure your WordPress site for Single Sign On

Your WordPress site needs know how to communicate with LaunchKey for single Sign-On.

Follow these steps:

1. Download the Metadata file for your Single Sign On profile. Details

Follow these steps to download the Metadata file for your Single Sign On profile.

  1. From your Single Sign On profile, click on the Metadata tab
  2. Click on the Download Metadata button
  3. This will begin the process of downloading the idp.xml Identity Profile file to your computer.

2. Upload the profile file to your WordPress site:

3. Enter the Entity ID you specified in Step 4 of of the Setup SSO in LaunchKey section of the wizard.

After you've supplied the Single Sign On profile file location above, click the Next button to save the profile data and proceed.

Okay, let's map your WordPress user in Single Sign On

The Single Sign On profile needs to map you user in its LaunchKey Organization with the user the WordPress site.

Follow these steps:

1. From the Single Sign On profile, click on the Users tab.

2. Enter the value %%%wp_username%%% in the input box next to your user in the list.

3. Click the Save button or remove focus from the input box to save the mapping.

Finished!

Congrats, LaunchKey Single Sign On and your WordPress site have been configured. To log in to WordPress with LaunchKey Single Sign On, simply click the "Login with LaunchKey" button on the login form.

Setting Up Other Users

Other users of this WordPress site can be mapped with users in the Organization. Details

Follow these steps to map additional users:

  1. Log into the LaunchKey Dashboard.
  2. From the main menu, select Organizations.
  3. Click on the tile for the Organization under which you configured your SSO profile.
  4. Click on the Users link at the top of the Organization's page.
  5. To add the users:
    1. Click the New User button.
    2. Enter the following data:
      • First name First name of the user to add to your organization.
      • Last name Last name of the user to add to your organization.
      • Email address Email address of the user to add to your organization.
    3. Press the Invite button. The user will receive an email request to join the Organization.
    4. Repeat until all users have been added.
  6. Scroll to the Single Sign On section and click the single sign on configuration for your WordPress installation.
  7. Click on the Users tab.
  8. Enter the user names for the WordPress site in the input box next to their Organization user name to map their account. If the user name does not exist in the WordPress installation, it will be automatically created once they log in with SSO and select your WordPress site from the application list. If the user is created by the LaunchKey plugin, the user's role will be the value set on the role key in the Attributes tab. The value defaults to admin when the SSO profile is created.

Click the Finish button below to proceed to the standard settings and configuration page.

Configuration Details

The implementation type for your site:

LaunchKey MFA

Standard multi-factor authentication utilizing the LaunchKey Authenticator App

LaunchKey Single Sign On

Multi-factor authentication utilizing the LaunchKey Single Sign On

White Label

Multi-factor authentication utilizing your own mobile app via the LaunchKey white label SDK

These settings should match the information found within your Application inside LaunchKey Dashboard

10 digit Application Key for your LaunchKey Application

Current secret key hidden for security

32 character alpha-numeric Secret Key for your LaunchKey Application

Current private key hidden for security

10 digit Application Key for your LaunchKey Application

%%%callback_url%%%

Save Changes

Advanced Settings

Only modify these settings if you want to implement a non-standard WordPress integration.

Uncheck this box to disable SSL certificate verification

Warning: turning off SSL verification may make it impossible to log in with Launchkey.
Use this as a last resort due to SSL errors communicating with LaunchKey

The display name setting allows you to set the name that will be used to refer to the mobile app that will be used to pair and authenticate users with this WordPress site. It should be similar if not the same as the name of your White Label app.

Single Sign On Settings

Unique Identifier for this service in your organization. This value should match the Entity ID in the Configuration section of the General tab in your SSO details page.

Single Sign On Metadata

These settings come from the Metadata tab in your SSO details page for the Single Sign On profile in your Organization in the LaunchKey Dashboard.

You may update your SSO metadata by uploading a new idp.xml file that is downloaded by clicking on the Download Metadata button in the Metadata tab in your SSO details page.

%%%sso_post_url%%%

This value must be set in Post URL field in the Configuration section of the General tab in your SSO details page.

%%%sso_login_url%%%

This is the URL to which users will be redirected when they click the "Log in with LaunchKey" button on the Login page. The URL must match the Login URL field in the Metadata tab in your SSO details page.

If this data does not match, you will need to update via the update metadata field.

%%%sso_logout_url%%%

This is the URL to which users will be redirected when they log out of WordPress. The URL must match the Logout URL field in the Metadata tab in your SSO details page.

If this data does not match, you will need to update via the update metadata field.

%%%sso_error_url%%%

This is the URL to which users will be redirected when they encounter an error logging into WordPress via SSO. The URL must match the Logout URL field in the Metadata tab in your SSO details page.

If this data does not match, you will need to update via the update metadata field.

%%%sso_public_key%%%

This is the RSA public key certificate that is used to verify SAML requests from the LaunchKey SSO server. The certificate must match the Certificate in the Metadata tab in your SSO details page.

If this data does not match, you will need to update via the update metadata field.

Save Changes