This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Adding Service Principals

Follow the instructions below to add a Service Principal to the WSO2 Identity Server.

1. Sign in. Enter your user name and password to log on to the Management Console as described here for Windows users and here for Linux users.

2. Click the "Configure" button to access the "Configure" menu.

3. From the "Configure" menu, select "Service Principals."

4. Click on the "Add New Service Principal" link to add a new Service Principal in the "Service Principal Management" page, where the following information is displayed.

  • Service Principal Name – Name of the service principal. This usually takes the following format: <Service Name>/<Host where service is running>.
  • Description – Brief description of the service principal. This field is not mandatory.
  • Actions – Lists the actions you can carry out on the selected service principal.

5. Specify the required information on the "Service Principal Management" page.

  • Service Principal Name – Name of the service principal. This usually takes following format: <Service Name>/<Host where service is running>. This field is mandatory.
  • Password – The password given to the service principal. You would use this password in the appropriate service's rampart configuration. Thus, the appropriate service will provide a password, given in rampart configuration, to KDC when it needs to authenticate itself to KDC. This field is mandatory.
  • Re-Type Password – Re-type password provided in the "Password" section to make sure the given password is accurate. This field is mandatory.
  • Description – Brief description of the service principal. This field is not mandatory.

6. Click on the "Finish" button.