webMethods Single Sign-On with a Third-Party Identity Provider
Tags: webmethods, okta, singlesignon, sso
Published: 2019-08-16 13:22:48

---
title: webMethods Single Sign-On with a Third-Party Identity Provider
published: true
tags: webmethods, okta, single-sign-on, sso
canonical_url: http://techcommunity.softwareag.com/techniques-blog/-/blogs/webmethods-single-sign-on-with-a-third-party-identity-provider
---

# Example with OKTA®

Increasingly companies rely on third-party providers for identity management and authentication. The benefits include better protection against data breaches as well as a seamless user experience when switching between applications. My webMethods Server (MWS) also provides support for integrating third-party identity providers.

## **Why Single Sign-On (SSO)?**

SSO gives us the convenience to log in once and access multiple applications from various vendors and hosted on different environments. As the application landscape of enterprises becomes increasingly complex, this convenience becomes a must-have feature.

## **Using a third-party identity provider**

A third-party Identity Provider (IDP) provides user identities and the login functionality to authenticate users. Once the login is verified, the user is then forwarded to the requested application also called a Service Provider (SP). The communication between identity and service provider is conducted through the Secure Assertion Markup Language (SAML) protocol.

## **IDP initiated vs. SP initiated login**

You can sign into a single sign-on service by browsing to the:

- Application - This is called a Service Provider initiated (SP-initiated) login
- Identity provider – This is called an Identity Provider initiated (IDP-initiated) login

![SAML Flow](http://techcommunity.softwareag.com/documents/10157/10255328/sso1.png/f4cbedcb-ef6f-417c-a56b-2e0080c08b23?t=1548937276319)

As of version 10.3 My webMethods Server only supports IDP initiated login (see point 4).

## **Setting up MWS**

The setup of MWS for SSO using a third-party IDP can be accomplished in three steps.

1. Ensure that the MWS is setup for HTTPS communication as the authentication uses SSL certificates
2. Provide MWS with the address of the IDP by modifying the websso.properties file
3. Import the IDP’s certificate to the MWS trustStore

The setting become active after restarting the MWS server. You can test the configuration by creating a demo IDP account with OKTA.

## **Creating an OKTA developer account**

OKTA provides a free developer account, which can be set up for SSO to MWS. Create a SAML web application and provide the MWS connection details. Once the application is created, note the embed link URL.

![](http://techcommunity.softwareag.com/documents/10157/10255328/sso2.png/0c9079c1-4227-42fa-8a61-c82de491be36?t=1548937279998)

## **Try it out**

To test the IDP initiated login to MWS simply open a browser window and enter the embed URL link from your OKTA application.

![](http://techcommunity.softwareag.com/documents/10157/10255328/sso3.png/8b51f99d-f31b-4898-bd56-c391a46a24a6?t=1548937282880)

After successful login, OKTA will redirect you to MWS start page as you will already be logged in.

## **In summary**

These simple steps make it easy to include MWS in your SSO landscape. The procedure can also be used to implement other third-party IDPs such as Microsoft® ADFS. The technical implementation details can be found in the “Administering My webMethods Server” found on the Software AG documentation website.

**Resources**

Configure MWS for SAML SSO - 10-3\_Administering\_My\_Webmethods\_Server.pdf: Page 297 - Configuring Single Sign-On for Using a Third-Party Identity Provider 
[http://techcommunity.softwareag.com/ecosystem/documentation/webmethods/mywebmethods_server/mws10-3/10-3_Administering_My_Webmethods_Server.pdf](http://techcommunity.softwareag.com/ecosystem/documentation/webmethods/mywebmethods_server/mws10-3/10-3_Administering_My_Webmethods_Server.pdf)

Implementing webMethods Single Sign On with a Third-party Identity Provider - OKTA - [http://techcommunity.softwareag.com/pwiki/-/wiki/Main/Implementing+webMethods+Single+Sign+On+with+a+Third-party+Identity+Provider+-+OKTA]
(http://techcommunity.softwareag.com/pwiki/-/wiki/Main/Implementing+webMethods+Single+Sign+On+with+a+Third-party+Identity+Provider+-+OKTA)

Setup sample application in OKTA - [https://developer.okta.com/standards/SAML/setting\_up\_a\_saml\_application\_in\_okta](https://developer.okta.com/standards/SAML/setting_up_a_saml_application_in_okta)

Information about SAML - [https://www.okta.com/integrate/documentation/saml/](https://www.okta.com/integrate/documentation/saml/)