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 minutes 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.

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

Begin Setup

First, let’s pair your mobile device with LaunchKey

Follow these steps:

1. Download the free LaunchKey mobile app on iOS, Android, or Windows Phone. Details

LaunchKey Mobile is a free app from LaunchKey that will allow you to receive authentication requests from WordPress and other LaunchKey-secured applications on your smartphone or tablet. Download LaunchKey in the Apple App Store, Google Play, or Windows Store.

2. Open the app and tap the Create Account button and complete the form Details

After you’ve downloaded LaunchKey Mobile, open the app and tap the Create Account button in the lower left-hand corner of the screen and complete the form. Only one pairing method (email or SMS) is required.

Username - Choose a LaunchKey username (min. 6 characters) that you’re comfortable memorizing

Device Name - Name your device anything you’ll recognize

Email Address - Enter your email address to receive a confirmation email to complete pairing

Phone Number - U.S. only. Enter your phone number to receive a confirmation SMS to complete pairing

3. Respond to the LaunchKey pair confirmation sent to you via email, SMS, or both. Details

To complete the account creation process and successfully pair your mobile device with LaunchKey, a confirmation request will be emailed or texted to you with very brief instructions to confirm and finish the LaunchKey device setup process. If you provided both an email address and phone number, you will be sent an email AND a text message. Follow the very brief instructions in the confirmation request(s) to finish pairing your device.

4. When the pending screen within LaunchKey Mobile disappears, your mobile device has been paired and you’re ready to move to the next step Details

After you’ve responded to the confirmation request that was emailed or texted to you (or both), LaunchKey will push a notification to your mobile device informing it that setup is complete. When your device receives this notification, the pending screen within LaunchKey Mobile should disappear.

If you completed the confirmation instructions, but a push notification wasn’t received and/or the pending screen is still visible in LaunchKey Mobile, tap the refresh button in the top right of the pending screen to manually check your status. If you tap refresh and the pending screen is still there, start the account creation process over again, and consider utilizing an alternate pairing confirmation method.

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

Where do you want users to receive your WP login requests?

With LaunchKey, you can choose whether you want your WordPress users to receive and respond to login requests through the free LaunchKey mobile app or through your own mobile app by utilizing our White Label SDK. Note: LaunchKey White Label will require additional mobile development work, while utilizing the free LaunchKey mobile app will not.

Select the Authenticator you want to use:

Recommended

Free LaunchKey mobile app

Use this option for the quickest and easiest implementation. No mobile integration or additional development work required.

Use LaunchKey Mobile

Advanced

Your own mobile app

Additional mobile app development required to integrate the White Label SDK. Must have your own iOS, Android, or Windows Phone mobile app(s).

Use White Label SDK

Single Sign On

LaunchKey Single Sign On

Use this option if your Organization has Single Sign On and you want to configure this site to use that Single Sign On.

Use Single Sign On
< Choose a different option

Okay, let’s create a Rocket for your WordPress site

To ensure your WordPress site can communicate with the LaunchKey service, you need to create a LaunchKey Rocket within Dashboard. A Rocket 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 Rocket 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 Rocket button. Details

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

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

Next

NOTICE

You have chosen to utilize LaunchKey White Label. In addition to completing the steps on this page, you will need to follow the LaunchKey White Label Developer Docs to properly embed and configure the White Label SDK within your iOS, Android, or Windows Phone mobile app(s).

For an easier setup process that doesn’t require mobile app development, switch to the standard integration otherwise proceed with the instructions below.

Okay, first let’s create an Organization in Dashboard

You’ve selected to implement the LaunchKey White Label SDK within your own mobile app so that your WordPress users will receive login requests within a mobile app you own rather than the free LaunchKey mobile app. Click here to change your choice. To proceed, create an Organization in Dashboard.

Follow these steps:

1. Create a new Organization here: https://dashboard.launchkey.com/organizations/create

2. In the form, choose an Organization name, description (optional), and avatar (optional).

3. Enter your name and email address in the Admin Information section, and click the Create Organization button to submit the form.

4. Check your inbox for a confirmation email and click the link it contains.

Now let’s create a White Label Group

Once you’ve clicked the link in your Create Organization confirmation email, you will be forwarded to your Organization Details page within Dashboard. Now we’ll need to create a White Label Group.

Follow these steps:

1. From your Organization Details page, click the New White Label Group button within the White Label Groups subsection.

2. In the form, enter a name to identify your White Label Group (name is private), and click the Create button.

Lastly, create a White Label Rocket for your WordPress site

To ensure your WordPress site can communicate with the LaunchKey service and your mobile app(s) containing the LaunchKey White Label SDK, you need to create a Rocket within Dashboard. A Rocket 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.

Follow these steps:

1. From your new White Label Group details page, click the New Rocket button in the Rockets subsection.

2. Choose a name, description, and avatar that you want users to see when they receive a login request from your WordPress site.

3. Read and agree to the Developer Terms of Service, and then click the Create Rocket button.

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

Next

Add this Callback URL to your Rocket

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 Rocket will post resonses to your WordPress site using the Callback URL below. Add this URL to the configuration options of your Rocket. View less

Your Callback URL is:

%%%callback_url%%%

Follow these instructions:

1. If you’re not already on the details page of your new Rocket, click on the menu icon within Dashboard, select Rockets, and click on the name of the Rocket 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 Rocket are saved automatically. Click Next to proceed.

Next

Almost done! Configure this plugin with keys from your Rocket

Follow these steps:

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

2. Copy the value next to Rocket 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:

5. 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.

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 Rocket name, description, and avatar you chose earlier.

Pair your device.

Pair

Verify

Check your mobile device for a Launch Request. If you do not receive the push notification, you may need to refresh the Orbit screen in the app to get the request or manually authenticate for a White Label app.

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, but leave the password field blank.

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.

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

Finish
< 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...

Next Back

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.

Next

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 the initial :

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

Next

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.

Next

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 WordPress users 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.

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

Finish

Configuration Details

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

10 digit Rocket Key for your LaunchKey Rocket

Current secret key hidden for security

32 character alpha-numeric Secret Key for your LaunchKey Rocket

Current private key hidden for security

10 digit Rocket Key for your LaunchKey Rocket

%%%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 Organizaion 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