--- title: "authUser (Service) [v2]" slug: "dpgw-ig-authuser-service-v2-5-12" updated: 2026-01-14T12:10:33Z published: 2026-01-14T17:11:00Z canonical: "docs.onespan.com/dpgw-ig-authuser-service-v2-5-12" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # authUser (Service) [v2] > API version: 2 > > Availability: DIGIPASS Gateway 5.0 and later > > Authentication: Basic HTTP authentication using the front-end API key. The authUser service completes a pending push and login authentication. It resumes an authentication request that the serving OneSpan Authentication Server instance previously suspended during a SOAP call (authUser) from the application server. The authentication request is retrieved by the client using getPreparedSecureChallenge. The respective authentication request is identified by a challenge key previously received via push notification (see [getPreparedSecureChallenge (service) [v2]](/sec/docs/dpgw-ig-getpreparedsecurechallenge-service-v2-5-12)). ## URL https://dpgateway_host:dpgateway_port/rest/v2/authentication/push /authUser ## Request | authUser parameters | | --- | | Parameter name | Data type | Description | | challengeKey | String | Required. The unique identifier used by OneSpan Authentication Server to identify a login request. | | domain | String | Optional. The unique identifier used by OneSpan Authentication Server to identify a group user. | | signature | String | Required. The signature generated with the Digipass SDK using the Secure Channel message containing the login details. | | userID | String | Required. The unique identifier used by OneSpan Authentication Server to identify a user. | ### Example ```json {  "userID": "jane.doe",  "domain": "mydomain.com",  "challengeKey": "0123456789",  "signature": "1234567890123456" } ``` ## Response | authUser return values | | --- | | Return value | Description | | resultCodes | A JSON object that contains the return and status codes of the service. | | result | A JSON object that contains the resolved user information and the serial number of the Digipass authenticator that is effectively used to complete the authentication request. | ### Example ```json {  "resultCodes":    {      "returnCodeEnum": "RET_SUCCESS",      "statusCodeEnum": "STAT_SUCCESS",      "returnCode": 0,      "statusCode": 0    },  "result":    {      "userID": "jane.doe",      "domain": "mydomain.com",      "orgUnit": "",      "serialNo": "VDS1000120-1"    } } ```