CollapseAll image

Set Admin User Information

The following steps describe how to set the admin username and password.

1.  Retrieve the value of the AMT_GeneralSettings.DigestRealm property:

a.   Find the instance of CIM_ComputerSystem representing the Intel AMT, as described in Discovering CIM_ComputerSystem.

b.   From the CIM_ComputerSystem instance, traverse the CIM_ElementSettingData association class to find the instance of AMT_GeneralSettings.

2.  If the Admin Password will be changed, compute DigestPassword by using MD5 Hashing function:

DigestPassword = MD5 (username + “:” + AMT_GeneralSettings.DigestRealm + “:” + plaintextPassword);

 

 Note:

The plaintext password can be based on a Digest Master Password.

 

3.  Retrieve the instance of AMT_ AuthorizationService, where the “Name” key equals “Intel(r) AMT Authorization Service”.

4.  Invoke AMT_AuthorizationService.SetAdminAclEntryEx with the following parameters:

Parameter

Value

Username

Username for access control. Contains 7-bit ASCII characters. String length is limited to 16 characters. Username cannot be an empty string.

DigestPassword

Digest Password computed in step 2

(include if the Password is to be changed)

 

Click here for a snippet demonstrating this step

See Snippet Functions for the ConvertToBase64 and ComputeMD5 functions.

See the first snippet in the Add a Digest User use case for the GetDigestRealm function.

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

  

$authorizationServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_AuthorizationService WHERE Name='Intel(r) AMT Authorization Service'")

$inputObject =$authorizationServiceRef.CreateMethodInput("SetAdminAclEntryEx")

$digestRealm = GetDigestRealm

$digestPassword = ComputeMD5 "myUser" "P@ssw0rd" $digestRealm

$digestPasswordInBase64 = ConvertToBase64 $digestPassword

$inputObject.SetProperty("Username","myUser")

$inputObject.SetProperty("DigestPassword",$digestPasswordInBase64)

$outputObject =$authorizationServiceRef.InvokeMethod($inputObject)

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

 

 

Instance Diagram

Not applicable

Classes Used in This Flow

SDK Sample

Not applicable

 

See Also:

   Intel AMT Users and Permissions/Realms

   Valid Usernames and Passwords

   Administrative Users

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