Package io.jans.as.server.ssa.ws.rs

Interface SsaRestWebService

  • All Known Implementing Classes:
    SsaRestWebServiceImpl
    public interface SsaRestWebService
    Interface to handle all SSA REST web services.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      jakarta.ws.rs.core.Response create​(java.lang.String requestParams, jakarta.servlet.http.HttpServletRequest httpRequest)
      Create SSA for the organization with "expiration" (optional).
      jakarta.ws.rs.core.Response get​(java.lang.String jti, java.lang.Long orgId, jakarta.servlet.http.HttpServletRequest httpRequest)
      Get list of SSA based on "jti" or "org_id" filter.
      jakarta.ws.rs.core.Response revoke​(java.lang.String jti, java.lang.Long orgId, jakarta.servlet.http.HttpServletRequest httpRequest)
      Revokes existing active SSA based on "jti" or "org_id".
      jakarta.ws.rs.core.Response validate​(java.lang.String jti)
      Validate existing active SSA based on "jti".

    • Method Detail

      • create

        @POST
@Path("/ssa")
@Produces("application/json")
jakarta.ws.rs.core.Response create​(java.lang.String requestParams,
                                   @Context
                                   jakarta.servlet.http.HttpServletRequest httpRequest)
        Create SSA for the organization with "expiration" (optional).
        Parameters:
        requestParams - Valid json
        httpRequest - Http request object
        Returns:
        Response with status 201 (Created) and with body the ssa token, or with status 401 (Unauthorized) if unauthorized access request, or with status 500 (Internal Server Error) if internal error occurred.

      • get

        @GET
@Path("/ssa")
@Produces("application/json")
jakarta.ws.rs.core.Response get​(@QueryParam("jti")
                                java.lang.String jti,
                                @QueryParam("org_id")
                                java.lang.Long orgId,
                                @Context
                                jakarta.servlet.http.HttpServletRequest httpRequest)
        Get list of SSA based on "jti" or "org_id" filter.
        Parameters:
        jti - Unique identifier
        orgId - Organization ID
        httpRequest - Http request
        Returns:
        the Response with status 200 (Ok) and with body the ssa list, or with status 401 (Unauthorized) if unauthorized access request, or with status 500 (Internal Server Error) if internal error occurred.

      • validate

        @HEAD
@Path("/ssa")
@Produces("application/json")
jakarta.ws.rs.core.Response validate​(@HeaderParam("jti")
                                     java.lang.String jti)
        Validate existing active SSA based on "jti".
        Parameters:
        jti - Unique identifier
        Returns:
        Response with status 200 (Ok) if is was validated successfully, or with status 401 (Unauthorized) if unauthorized access request, or with status 500 (Internal Server Error) if internal error occurred.

      • revoke

        @DELETE
@Path("/ssa")
@Produces("application/json")
jakarta.ws.rs.core.Response revoke​(@QueryParam("jti")
                                   java.lang.String jti,
                                   @QueryParam("org_id")
                                   java.lang.Long orgId,
                                   @Context
                                   jakarta.servlet.http.HttpServletRequest httpRequest)
        Revokes existing active SSA based on "jti" or "org_id".
        Parameters:
        jti - Unique identifier
        orgId - Organization ID
        httpRequest - Http request
        Returns:
        the Response with status 200 (Ok) if it was revoked successfully, or with status 401 (Unauthorized) if unauthorized access request, or with status 500 (Internal Server Error) if internal error occurred.