# Managed Object - CryptoManagerHost(vim.encryption.CryptoManagerHost)

Extended by
  CryptoManagerHostKMS
Extends
  CryptoManager
See also
  CryptoKeyPlain
Since
  vSphere API 6.7

## Managed Object Description

Properties

Name | Type | Description
--- | --- | ---
None
Properties inherited from CryptoManager
enabled

Methods

Methods defined in this Managed Object
ChangeKey_Task, CryptoManagerHostEnable, CryptoManagerHostPrepare
Methods inherited from CryptoManager
AddKey, AddKeys, ListKeys, RemoveKey, RemoveKeys

# ChangeKey_Task(changeKey)

Change the key used for core dump encryption Note: CryptoManagerHostEnable must be called first If successful, a "best effort" will be made to "in place" shallow recrypt any core dumps found in /var/core to use the new key.

Required Privileges
  Cryptographer.RegisterHost

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the CryptoManagerHost used to make the method call.
newKey | CryptoKeyPlain | The key that replaces the existing core dump encryption key

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task |

Faults

Type | Description
--- | ---
InvalidState | Thrown if the host is not in safe state
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

# CryptoManagerHostEnable(enable)

Begin core dump encryption by specifying the encryption key and put the host in safe state Note: CryptoManagerHostPrepare must be called first

Required Privileges
  Cryptographer.RegisterHost

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the CryptoManagerHost used to make the method call.
initialKey | CryptoKeyPlain | The key to be used for core dump encryption

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
AlreadyExists | Thrown if the host is in safe state and initialKey differs from the existing core dump encryption key
InvalidState | Thrown if the host is in incapable state
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="CryptoManagerHostEnable" type="vsan:CryptoManagerHostEnableRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="CryptoManagerHostEnableResponse"> <complexType/> </element>

# CryptoManagerHostPrepare(prepare)

Prime the host to receive sensitive information and put the host in prepared state

Required Privileges
  Cryptographer.RegisterHost

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the CryptoManagerHost used to make the method call.

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
InvalidState | Thrown if the host is not in incapable state
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="CryptoManagerHostPrepare" type="vsan:CryptoManagerHostPrepareRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="CryptoManagerHostPrepareResponse"> <complexType/> </element>