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

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

SDK Sample

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

 

See Also:

   User Consent Tool

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.