SetSecurityPreference - Resource Access Management - Centro de documentación de Alibaba Cloud

Configura las preferencias de seguridad globales para un usuario de RAM.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ram:SetSecurityPreference

update

*All Resource

*

ram:MFAOperationForLogin

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
EnableSaveMFATicket	boolean	No	Especifica si un usuario de RAM que inicia sesión con autenticación multifactor (MFA) puede omitir la MFA durante los siguientes siete días. Valores válidos: true: Permitido. false (valor predeterminado): No permitido.	false
AllowUserToChangePassword	boolean	No	Especifica si los usuarios de RAM pueden cambiar sus propias contraseñas. Valores válidos: true (valor predeterminado): Permitido. false: No permitido.	true
AllowUserToManageAccessKeys	boolean	No	Especifica si los usuarios de RAM pueden gestionar sus propias AccessKeys. Valores válidos: true: Permitido. false (valor predeterminado): No permitido.	false
AllowUserToManageMFADevices	boolean	No	Especifica si los usuarios de RAM pueden gestionar sus propios dispositivos MFA. Valores válidos: true (valor predeterminado): Permitido. false: No permitido.	true
LoginSessionDuration	integer	No	La duración de la sesión de un usuario de RAM que inicia sesión en la consola. Unidad: horas. Valores válidos: 1 a 24. Valor predeterminado: 6.	6
LoginNetworkMasks	string	No	La máscara de dirección IP que se utiliza para iniciar sesión en la consola. Esta máscara se aplica a los inicios de sesión basados en contraseña y a los inicios de sesión único (SSO), pero no afecta a las llamadas a la API que se realizan mediante un par de AccessKey. Si especifica una máscara, los usuarios de RAM solo pueden iniciar sesión en la consola desde las direcciones IP especificadas. Si no especifica una máscara, los usuarios de RAM pueden iniciar sesión en la consola desde todas las direcciones IP. Si necesita especificar varias máscaras, sepárelas con punto y coma (`;`). Ejemplo: `192.168.0.0/16;10.0.0.0/8`. Puede especificar hasta 40 máscaras. La longitud total no puede exceder los 512 caracteres.	10.0.0.0/8
VerificationTypes	array	No	Los métodos de MFA.
	string	No	El método de MFA. Valores válidos: `sms`: mensaje de texto `email`: correo electrónico	["sms", "email"]
AllowUserToManagePersonalDingTalk	boolean	No	Especifica si los usuarios de RAM pueden vincular o desvincular sus cuentas personales de DingTalk. Valores válidos: true (valor predeterminado): Permitido. false: No permitido.	true
OperationForRiskLogin `deprecated`	string	No	Este parámetro está obsoleto.	autonomous
MFAOperationForLogin	string	No	Especifica la política de MFA para el inicio de sesión del usuario. Este parámetro reemplaza a `EnforceMFAForLogin`. Se recomienda utilizar este parámetro. `EnforceMFAForLogin` sigue siendo válido. Valores válidos: `mandatory`: aplica la MFA obligatoria para todos los usuarios de RAM. Esto equivale a establecer `EnforceMFAForLogin` en `true`. `independent` (valor predeterminado): La configuración de MFA de cada usuario de RAM no se ve afectada. Esto equivale a establecer `EnforceMFAForLogin` en `false`. `adaptive`: aplica la MFA obligatoria solo para inicios de sesión inusuales.	adaptive
MaxIdleDaysForAccessKeys	integer	No	El periodo máximo de inactividad de los pares de AccessKey de los usuarios de RAM. Un par de AccessKey que no se utilice durante el periodo de tiempo especificado se deshabilita automáticamente al día siguiente. Puede establecer el valor en uno de los siguientes números: 90 180 365 730 (valor predeterminado)	365
MaxIdleDaysForUsers	integer	No	El periodo máximo de inactividad de los usuarios de RAM. Si un usuario de RAM que puede iniciar sesión en la consola no inicia sesión durante el periodo de tiempo especificado (los inicios de sesión SSO no se incluyen), la función de inicio de sesión en la consola del usuario de RAM se deshabilita al día siguiente. Puede establecer el valor en uno de los siguientes números: 90 180 365 730 (valor predeterminado)	365
AllowUserToLoginWithPasskey	boolean	No	Especifica si los usuarios de RAM pueden usar passkeys para iniciar sesión en la consola. Valores válidos: true (valor predeterminado): Permitido. false: No permitido.	true
AllowUserToManageServiceCredentials	boolean	No	Especifica si los usuarios de RAM pueden gestionar sus propias claves de API. Valores válidos: true: Permitido. false: No permitido.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los datos devueltos.
SecurityPreference	object	Las preferencias de seguridad.
AccessKeyPreference	object	Las preferencias de AccessKey.
AllowUserToManageAccessKeys	boolean	Especifica si los usuarios de RAM pueden gestionar sus propias AccessKeys.	false
AllowUserToManageServiceCredentials	boolean	Especifica si los usuarios de RAM pueden gestionar sus propias claves de API. Valores válidos: true: Los usuarios de RAM pueden gestionar sus propias claves de API. false: Los usuarios de RAM no pueden gestionar sus propias claves de API.	false
LoginProfilePreference	object	Las preferencias de inicio de sesión.
EnableSaveMFATicket	boolean	Especifica si se debe guardar el estado de verificación durante siete días después de que un usuario de RAM completa la autenticación multifactor (MFA) durante el inicio de sesión.	false
LoginSessionDuration	integer	La duración de la sesión de inicio de sesión para un usuario de RAM, en horas.	6
LoginNetworkMasks	string	La máscara de red de inicio de sesión.	10.0.0.0/8
AllowUserToChangePassword	boolean	Especifica si los usuarios de RAM pueden gestionar sus propias contraseñas.	true
OperationForRiskLogin `deprecated`	string	Este parámetro está obsoleto.	autonomous
MFAOperationForLogin	string	La política de MFA para el inicio de sesión del usuario. Este parámetro es el reemplazo recomendado para `EnforceMFAForLogin`, que aún se admite.	adaptive
AllowUserToLoginWithPasskey	boolean	Especifica si los usuarios de RAM pueden iniciar sesión con una passkey.	false
MFAPreference	object	Las preferencias de MFA (autenticación multifactor).
AllowUserToManageMFADevices	boolean	Especifica si los usuarios de RAM pueden gestionar sus propios dispositivos MFA.	false
VerificationPreference	object	Las preferencias para los métodos de MFA.
VerificationTypes	array	Los métodos de MFA permitidos.
	string	El método de MFA.	["sms", "email"]
PersonalInfoPreference	object	Las preferencias de información personal.
AllowUserToManagePersonalDingTalk	boolean	Especifica si los usuarios de RAM pueden vincular o desvincular sus cuentas personales de DingTalk.	true
MaxIdleDays	object	Configuración para el periodo máximo de inactividad en días.
MaxIdleDaysForUsers	integer	El periodo máximo de inactividad, en días, para un usuario de RAM. Si un usuario de RAM con el inicio de sesión en la consola habilitado no inicia sesión dentro de este periodo, el sistema deshabilita automáticamente su inicio de sesión en la consola al día siguiente. Esta configuración no se aplica al inicio de sesión único (SSO). Valor predeterminado: 730.	730
MaxIdleDaysForAccessKeys	integer	El periodo máximo de inactividad, en días, para una AccessKey de un usuario de RAM. Si una AccessKey no se utiliza dentro del periodo especificado, el sistema la deshabilita automáticamente al día siguiente. Valor predeterminado: 730.	730
RequestId	string	El ID de la solicitud.	17494710-B4BA-4185-BBBB-C1A6ABDE1639

Ejemplos

Respuesta exitosa

JSON Formato

{
  "SecurityPreference": {
    "AccessKeyPreference": {
      "AllowUserToManageAccessKeys": false,
      "AllowUserToManageServiceCredentials": false
    },
    "LoginProfilePreference": {
      "EnableSaveMFATicket": false,
      "LoginSessionDuration": 6,
      "LoginNetworkMasks": "10.0.0.0/8",
      "AllowUserToChangePassword": true,
      "OperationForRiskLogin": "autonomous",
      "MFAOperationForLogin": "adaptive",
      "AllowUserToLoginWithPasskey": false
    },
    "MFAPreference": {
      "AllowUserToManageMFADevices": false
    },
    "VerificationPreference": {
      "VerificationTypes": [
        "[\"sms\", \"email\"]"
      ]
    },
    "PersonalInfoPreference": {
      "AllowUserToManagePersonalDingTalk": true
    },
    "MaxIdleDays": {
      "MaxIdleDaysForUsers": 730,
      "MaxIdleDaysForAccessKeys": 730
    }
  },
  "RequestId": "17494710-B4BA-4185-BBBB-C1A6ABDE1639"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.