- Created by Documentation, last modified on Apr 09, 2018
disable_authentication_provider
disable_failing_authentication_providers
enable_authentication_provider
get_available_authentication_providers
get_provider_client_configurations
get_provider_configuration_fields
get_provider_display_configurations
get_users_authn_linked_accounts
set_provider_client_configurations
set_provider_display_configurations
twofactorauth_generate_tfa_config
twofactorauth_get_user_configs
cpgreylist_is_server_netblock_trusted
cpgreylist_list_entries_for_common_mail_provider
cpgreylist_load_common_mail_providers_config
cpgreylist_save_common_mail_providers_config
cpgreylist_trust_entries_for_common_mail_provider
cpgreylist_untrust_entries_for_common_mail_provider
create_cpgreylist_trusted_host
delete_cpgreylist_trusted_host
block_incoming_email_from_country
block_incoming_email_from_domain
expunge_messages_for_mailbox_guid
get_unique_recipient_count_per_sender_for_user
get_unique_sender_recipient_count_per_user
get_user_email_forward_destination
list_blocked_incoming_email_countries
list_blocked_incoming_email_domains
set_user_email_forward_destination
unblock_incoming_email_from_country
unblock_incoming_email_from_domain
Description
This function removes the Two-Factor Authentication (2FA) settings for one or more specified user accounts.
Note:
If you remove the 2FA settings for an account, the user must perform the setup procedure again to re-configure 2FA on the account.
Examples
https://hostname.example.com:2087/cpsess##########/json-api/twofactorauth_remove_user_config?api.version=1&user=example
https://hostname.example.com:2087/cpsess##########/xml-api/twofactorauth_remove_user_config?api.version=1&user=example
whmapi1 twofactorauth_remove_user_config user=example
Notes:
- Unless otherwise noted, you must URI-encode values.
- For more information and additional output options, read our Guide to WHM API 1 documentation or run the
whmapi1 --help
command. If you run CloudLinux™, you must use the full path of the
whmapi1
command:/usr/local/cpanel/bin/whmapi1
{ "data":{ "users_modified":[ "example" ], "failed":{ } }, "metadata":{ "version":1, "reason":"OK", "result":"1", "command":"twofactorauth_remove_user_config" } }
<result> <data> <users_modified>example</users_modified> <failed/> </data> <metadata> <version>1</version> <reason>OK</reason> <result>1</result> <command>twofactorauth_remove_user_config</command> </metadata> </result>
Note:
Parameters
Parameter | Type | Description | Possible values | Example |
---|---|---|---|---|
user | string | Required The account's username. Note: To remove multiple users, increment the parameter name. For example, | A valid string. | example |
Returns
Return | Type | Description | Possible values | Example |
---|---|---|---|---|
| array | An array of the user accounts for which you successfully removed 2FA settings.
| A valid array of cPanel account names. | example |
| hash | A hash of the user accounts for which removal failed.
| This hash includes the | |
| string | The reason for the failure. Note: The user's name is the return name. The function returns this value in the | A valid string. | You are not authorized to modify “example” |
Function information
API Version:
Available in:
WHM 54+
Methods:
GET, POST
Required Parameters:
user
Return Formats:
About WHM API 1
WHM API 1 performs functions and accesses data in WHM.
Notes:
- Some functions and parameters may require that you authenticate as the
root
user. - You must use the appropriate WHM ports (
2086
or2087
) to call WHM API functions.
Find a function
Related functions
-
Page:WHM API 1 Sections - Authentication — Authentication functions allow you to manage how users log in to a cPanel & WHM server.
-
Page:WHM API 1 Functions - twofactorauth_disable_policy — This function disables the Two-Factor Authentication (2FA) security policy on the server.
-
Page:WHM API 1 Functions - twofactorauth_enable_policy — This function enables the Two-Factor Authentication (2FA) security policy on the server.
-
Page:WHM API 1 Functions - twofactorauth_generate_tfa_config — This function generates a random secret and a one-time password authentication (OTP auth) URL for the user.
-
Page:WHM API 1 Functions - twofactorauth_get_issuer — This function returns the currently configured issuer.