This documentation is for WSO2 Identity Server 5.8.0 . View documentation for the latest release.

All docs This doc
Skip to end of metadata
Go to start of metadata

This section guides you through securing REST services and how requests to REST APIs are authenticated and authorized in WSO2 Identity Server.  

The requests that are sent via REST APIs are intercepted by tomcat valves and authenticated and authorized by an OSGI service. There are two OSGi services that provide the authentication and authorization service based on its own handlers.

  • WSO2 Identity Server supports the following authentication handlers
    • OAuth2AccessTokenHandler
    • ClientCertificateBasedAuthenticationHandler 
    • BasicAuthenticationHandler 
  • The authorization handler is based on the permission specified against a particular user role.  

You can write your own handlers for both authentication and authorization and register them in OSGI.

Let's learn how to authenticate and authorize REST APIs: 

  1. To enable the intercepting of services:
    1. Open the catalina-server.xml file found in the <IS_HOME>/repository/conf/tomcat directory. 
    2. Uncomment the following valves found under the <Engine name="Catalina"> tag.    

       <!-- Authentication and Authorization valve for the rest apis and we can configure context for this in identity.xml  -->
       <!--Valve className="org.wso2.carbon.identity.auth.valve.AuthenticationValve"/>
       <Valve className = "org.wso2.carbon.identity.authz.valve.AuthorizationValve"/-->
  2. To specify the resources that you want to secure:

    1. Open the identity.xml file found in the  <IS_HOME>/repository/conf/identity directory. 

    2. Specify the resource that you want to secure under the <ResourceAccssControl> as given below. 

      ParameterDescriptionSample Value
      Resource contextThis defines the resource context relative to the root context, which needs to be secured./api/identity/*
      securedThis specifies whether to enable or disable security in the given resource context.true
      http-methodThis defines the method as all, post, get, etc.all
      PermissionsThis defines the user role permission that is required to authorize the resource. You can enter multiple permission strings in a comma-separated list./permission/admin/login


          <Resource context="/api/identity/*" secured="true" http-method="all">
  3. To configure intermediate certificate validation, configure the following in the identity.xml file as given below. 

    ParameterDescriptionSample Value
    IntermediateCertificateValidationThis defines whether intermediate certificate validation is enabled or not.true
    IntermediateCertsThis specifies the context paths of the intermediate certificates.localhost
    ExemptContextThis specifies the context paths that needs to be excempted from intermediate certificate validation.


    <IntermediateCertValidation enable="true">

    When using intermediate certificate validation, CN will be taken as the username instead of retrieving from the header.

  • No labels