--- title: "DIGIPASS Gateway overview" slug: "dpgw-ig-digipass-gateway-overview-5-12" updated: 2026-01-14T12:09:33Z published: 2026-01-14T17:11:00Z canonical: "docs.onespan.com/dpgw-ig-digipass-gateway-overview-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. # DIGIPASS Gateway overview **DIGIPASS Gateway** acts as a front-end infrastructure that handles the online communication between OneSpan Authentication Server on one side, and OneSpan Mobile Authenticator, customized solutions of Mobile Authenticator Studio, and mobile applications integrating OneSpan Mobile Security Suite on the other. It is usually deployed in the demilitarized zone (DMZ) and isolates OneSpan Authentication Server from the (untrusted) mobile applications' networks. ## Overview DIGIPASS Gateway exposes services to mobile applications via a REST API that uses JSON (see [Requests handled by DIGIPASS Gateway service endpoints (v2)](/sec/docs/dpgw-ig-digipass-gateway-overview-5-12#Tab_RequestHandledByDPGWServiceEnpoint)). By default, the services are exposed via the following URI: dpgateway_host:dpgateway_port/context_path/rest/v2/functionality/service where: - dpgateway_host is the host running DIGIPASS Gateway. - dpgateway_port is the port of the DIGIPASS Gateway service, by default 11080 (TCP). - context_path is the web application context within your web server. If you install DIGIPASS Gateway using the installation package, it is deployed as the default web application (ROOT), hence context_path is empty. If you deploy the web application manually to an existing web server, context_path must be specified respectively in the requests. - functionality is the name of the functionality group, e.g. provisioning. - service is the name of the service endpoint. Clients need to use the POST method to submit service requests, e.g: POST https://192.0.2.1:11080/rest/v2/provisioning/getServerTime | Requests handled by DIGIPASS Gateway service endpoints (v2) | | --- | | Request | Action | Functionality | | DSAPPActivate | Performs a provisioning activation operation using DSAPP (see [DSAPPActivate (service)](/sec/docs/dpgw-ig-dsappactivate-service-5-12)). | Online activation | | DSAPPMdlAddDevice | Registers a new device that supports Secure Channel activation (see [DSAPPMdlAddDevice (service)](/sec/docs/dpgw-ig-dsappmdladddevice-service-5-12)). | Online activation | | DSAPPRegister | Performs a provisioning registration operation using DSAPP (see [DSAPPRegister (service)](/sec/docs/dpgw-ig-dsappregister-service-5-12)). | Online activation | | DSAPPSRPGenerateActivationData | Retrieves Activation Message 1 (license) (see [DSAPPSRPGenerateActivationData (service) [v2]](/sec/docs/dpgw-ig-dsappsrpgenerateactivationdata-service-v2-5-12)). | Online activation | | DSAPPSRPGenerateEphemeralKey | Initializes the activation process by exchanging public keys (see [DSAPPSRPGenerateEphemeralKey (service) [v2]](/sec/docs/dpgw-ig-dsappsrpgenerateephemeralkey-service-v2-5-12)). | Online activation | | getServerTime | Retrieves the current server time as Unix time (see [getServerTime (service)](/sec/docs/dpgw-ig-getservertime-service-5-12)). | Online activation | | MdlActivate | Finalizes the activation process (see [MdlActivate (service) [v2]](/sec/docs/dpgw-ig-mdlactivate-service-v2-5-12)). | Online activation | | MdlAddDevice | Retrieves Activation Message 2 (instance) (see [MdlAddDevice (service) [v2]](/sec/docs/dpgw-ig-mdladddevice-service-v2-5-12)). | Online activation | | MdlRegister | Generates Activation Message 2 for a specific user (see [MdlRegister (service) [v2]](/sec/docs/dpgw-ig-mdlregister-service-v2-5-12)). | Online activation | | authUser | Performs an online authentication (see [authUser (service)](/sec/docs/dpgw-ig-authuser-service-5-12)). | Online authentication | | authUser | Completes a pending push and login authentication (see [authUser (service) [v2]](/sec/docs/dpgw-ig-authuser-service-v2-5-12)). | Push and login | | cancelAuthUser | Cancels a pending push and login request (see [cancelAuthUser (service) [v2]](/sec/docs/dpgw-ig-cancelauthuser-service-v2-5-12)). | Push and login | | getPreparedSecureChallenge | Retrieves a prepared authentication request (see [getPreparedSecureChallenge (service) [v2]](/sec/docs/dpgw-ig-getpreparedsecurechallenge-service-v2-5-12)). | Push and login | | authSignature | Completes a pending data signing transaction (see [authSignature (service)](/sec/docs/dpgw-ig-authsignature-service-5-12)). | Push and sign | | cancelAuthSignatureRequest | Cancels a pending data signing transaction (see [cancelAuthSignatureRequest (service)](/sec/docs/dpgw-ig-cancelauthsignaturerequest-service-5-12)). | Push and sign | | getPreparedSignatureRequest | Retrieves a prepared signature request for transaction data signing (see [getPreparedSignatureRequest (service)](/sec/docs/dpgw-ig-getpreparedsignaturerequest-service-5-12)). | Push and sign | | authUser | Completes a pending scan and login authentication (see [authUser (service) [v2]](/sec/docs/dpgw-ig-scan-and-login-authuser-service-v2-5-12)). | Scan and login | | cancelAuthUser | Cancels a pending scan and login request (see [cancelAuthUser (service) [v2]](/sec/docs/dpgw-ig-scan-and-login-cancelauthuser-service-v2-5-12)). | Scan and login | | getPreparedSecureChallenge | Retrieves a prepared authentication request for scan and login (see [getPreparedSecureChallenge (service) [v2]](/sec/docs/dpgw-ig-scan-and-login-getpreparedsecurechallenge-service-v2-5-12)). | Scan and login | | authSignature | Completes a pending scan and sign transaction (see [authSignature (service)](/sec/docs/dpgw-ig-scan-and-sign-authsignature-service-5-12)). | Scan and sign | | cancelAuthSignatureRequest | Cancels a pending scan and sign transaction (see [cancelAuthSignatureRequest (service)](/sec/docs/dpgw-ig-scan-and-sign-cancelauthsignaturerequest-service-5-12)). | Scan and sign | | getPreparedSignatureRequest | Retrieves a prepared signature request for scan and sign (see [getPreparedSignatureRequest (service)](/sec/docs/dpgw-ig-scan-and-sign-getpreparedsignaturerequest-service-5-12)). | Scan and sign | | sendNotification | Sends a push notification message to a user (see [sendNotification (service) [v2]](/sec/docs/dpgw-ig-sendnotification-service-v2-5-12)). | Notification | | updateNotificationID | Registers a mobile application to receive notifications (see [updateNotificationID (service) [v2]](/sec/docs/dpgw-ig-updatenotificationid-service-v2-5-12)). | Notification | ## Authentication To use the DIGIPASS Gateway services, the mobile application must authenticate against DIGIPASS Gateway by using basic HTTP authentication. For this purpose, two separate API keys are generated when setting up DIGIPASS Gateway: - The front-end API key is required for services typically used by mobile applications, e.g. OneSpan Mobile Authenticator. - The back-end API key is required for services typically exposed to the solution's back-end side, e.g. the banking website. Which API key is specifically required by each command is specified in the API reference. The API key must be used as the user name for authentication. The password field is ignored and can be left empty. > Using an API key of 123456, you need to add the following HTTP header field to your request: > > Authorization: Basic MTIzNDU2Og== > > Or using `curl`: > > `curl -v -H "Content-Type: application/json" --data {} -u 123456: 192.0.2.1:11080/rest/v2/provisioning/getServerTime` For more information about installing DIGIPASS Gateway, see the [DIGIPASS Gateway Getting Started Guide](/sec/docs/dpgw-getting-started-guide-5-12). > The DIGIPASS Gateway API key is sensitive data and should be properly protected in the source code of the mobile application. We recommend encrypting it using the OneSpan White-Box Cryptography (WBC) SDK provided as part of the OneSpan Mobile Security Suite package. > You need the front-end API key when registering for a push notification account on the OneSpan Customer Portal. Note that the OneSpan Customer Portal refers to the API key as DP Gateway Password. ## API versions DIGIPASS Gateway provides different API versions. The current is API version 2. > API version 1 is deprecated and provided for backward-compatibility reasons and migration purposes only! Use only API version 2 for new implementations.