Send Consent Code

Intel AMT Features > User Consent > Use Cases > Send Consent Code

Send Consent Code

The following steps describe how to send the consent code retrieved from the user.

1. Retrieve the instance of IPS_OptInService, where the “Name” key equals “Intel(r) AMT OptIn Service”.

2. Examine the OptInState property to verify that it is DISPLAYED before sending the use consent code.

3. Invoke IPS_OptInService.SendOptInCode, providing the numeric code obtained from the user as the OptInCode parameter.

Note:

• If the consent code sent by this operation was accepted, an additional user consent code will not be required until a timeout period of 2 minutes of inactivity has elapsed (configurable to 1 to 15 minutes). Inactivity is defined as no TCP sessions opened on any of the redirection ports (KVM or Storage Redirection).

• Sending multiple invalid consent codes will cause the OptInState to return to NOT STARTED. See Denial-of-Service Attack Prevention for a description of this mechanism.

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

$optInServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM IPS_OptInService WHERE Name='Intel(r) AMT OptIn Service'")

$optInServiceInstance =$optInServiceRef.Get()

$optInState =$optInServiceInstance.GetProperty("OptInState")

if($optInState -like "2") # OptInState 2 = Displayed.

{

$inputObject =$optInServiceRef.CreateMethodInput("SendOptInCode")

$optInCode =# The numeric code obtained from the user.

$inputObject.SetProperty("OptInCode",$optInCode)

$outputObject =$optInServiceRef.InvokeMethod($inputObject)

$returnValue =$outputObject.GetProperty("ReturnValue")

}

Instance Diagram

Classes Used in This Flow

• IPS_OptInService

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.