---
title: "authUser (Command)"
slug: "oas-fullsdk-soapref-authuser-command-3-29"
updated: 2026-01-14T12:53:58Z
published: 2026-01-14T17:09:28Z
canonical: "docs.onespan.com/oas-fullsdk-soapref-authuser-command-3-29"
---
> ## 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 (Command)
> Scenario: Authentication
>
> Support: full-sdk auth-sdk
The authUser command can be used to send the following requests to OneSpan Authentication Server:
- Authenticate with Response-Only
- Authenticate with Challenge/Response
- Authenticate with push notifications (push and login)
- Authenticate with Cronto images (scan and login)
- Authenticate with Secure Channel, i.e. authentication with the getChallenge and getSecureChallenge commands (see [getChallenge (Command)](/sec/docs/oas-fullsdk-soapref-getchallenge-command-3-29) and [getSecureChallenge (Command)](/sec/docs/oas-fullsdk-soapref-getsecurechallenge-command-3-29)).
- Change server PIN
## Parameters
| Attribute name | Optionality |
| --- | --- |
| CREDFLD_AUTH_TYPE | Optional |
| CREDFLD_CHALLENGE | Optional (for 1-step C/R) |
| CREDFLD_CHALLENGE_KEY | Optional |
| CREDFLD_CHALLENGE_MESSAGE | Optional |
| CREDFLD_COMPONENT_TYPE | Mandatory |
| CREDFLD_CONFIRM_NEW_PIN | Optional |
| CREDFLD_CURRENT_PIN | Optional |
| CREDFLD_DOMAIN | Optional |
| CREDFLD_DP_RESPONSE | Optional |
| CREDFLD_NEW_PIN | Optional |
| CREDFLD_PASSWORD | Optional |
| CREDFLD_NONCE | Optional |
| CREDFLD_PASSWORD_FORMAT | Mandatory |
| CREDFLD_REQUEST_HOST_CODE | Optional |
| CREDFLD_SERIAL_NO | Optional |
| CREDFLD_STATIC_PASSWORD | Optional |
| CREDFLD_USER_ATTRIBUTE_GROUP | Optional |
| CREDFLD_USERID | Mandatory |
| Attribute name | Returned |
| --- | --- |
| CREDFLD_AUXILIARY_MESSAGE | If defined |
| CREDFLD_CHALLENGE | Optional (for 2-step C/R) |
| CREDFLD_CHALLENGE_KEY | If defined |
| CREDFLD_CHALLENGE_MESSAGE | If defined |
| CREDFLD_DOMAIN | If defined |
| CREDFLD_HOST_CODE | If defined |
| CREDFLD_NOTIFY_PASSWORD_EXPIRE_DATE | If defined |
| CREDFLD_ORGANIZATIONAL_UNIT | If defined |
| CREDFLD_SERIAL_NO | Optional |
| CREDFLD_STATUS_MESSAGE | If defined |
| CREDFLD_USERID | Always |
CREDFLD_SERIAL_NO is not returned, if a static password (and not an authenticator) was used for the authentication.
The CREDFLD_CHALLENGE attribute is used as input parameter for 1-step challenge/response authentication. If a user initiates a 2-step challenge/response authentication with a request keyword, the authUser command generates a response and returns it via the CREDFLD_CHALLENGE attribute as output parameter. For more information about challenge/response authentication, see [User authentication: Challenge/response](/sec/docs/oas-fullsdk-pg-user-authentication-challengeresponse-3-29).
## Examples
> Response-only
>
> Authentication request via response-only with server PIN and OTP (as cleartext combined password)
>
> ```markup
>
>
>
>
>
>
> jane.doe
> CREDFLD_USERID
>
>
> 1234703557
> CREDFLD_PASSWORD
>
>
> 0
> CREDFLD_PASSWORD_FORMAT
>
>
> SOAP Auth Client
> CREDFLD_COMPONENT_TYPE
>
>
>
>
>
> ```
> Scan and login request
>
> This is an example for the first blocking authUser request in a scan and sign workflow.
>
> ```markup
>
>
>
>
>
>
> user
> CREDFLD_USERID
>
>
> password
> CREDFLD_PASSWORD
>
>
> 0
> CREDFLD_PASSWORD_FORMAT
>
>
> 1234567890
> CREDFLD_CHALLENGE_KEY
>
>
> Client
> CREDFLD_COMPONENT_TYPE
>
>
> SCAN
> CREDFLD_AUTH_TYPE
>
>
>
>
>
> ```