hostbasedsetup

Documentation

Index

• Constants
• type AddNextCertInChain_INPUT
• type AddNextCertInChain_OUTPUT
• type AdminPassEncryptionType
• type AdminSetup_INPUT
• type AdminSetup_OUTPUT
• type AllowedControlModes
• type Body
• type CertChainStatus
• type CurrentControlMode
• type HostBasedSetupService
• type PullResponse
• type Response
  • func (r *Response) JSON() string
  • func (r *Response) YAML() string
• type ReturnValue
• type Service
  • func NewHostBasedSetupServiceWithClient(wsmanMessageCreator *message.WSManMessageCreator, client client.WSMan) Service
  • func (service Service) AddNextCertInChain(cert string, isLeaf bool, isRoot bool) (response Response, err error)
  • func (service Service) AdminSetup(adminPassEncryptionType AdminPassEncryptionType, digestRealm string, ...) (response Response, err error)
  • func (service Service) Enumerate() (response Response, err error)
  • func (service Service) Get() (response Response, err error)
  • func (service Service) Pull(enumerationContext string) (response Response, err error)
  • func (service Service) Setup(adminPassEncryptionType AdminPassEncryptionType, ...) (response Response, err error)
  • func (service Service) UpgradeClientToAdmin(mcNonce string, signingAlgorithm SigningAlgorithm, digitalSignature string) (response Response, err error)
• type Setup_INPUT
• type Setup_OUTPUT
• type SigningAlgorithm
• type UpgradeClientToAdmin_INPUT
• type UpgradeClientToAdmin_OUTPUT

Constants

const (
	IPS_HostBasedSetupService string = "IPS_HostBasedSetupService"
	Setup                     string = "Setup"
	AdminSetup                string = "AdminSetup"
	AddNextCertInChain        string = "AddNextCertInChain"
	UpgradeClientToAdmin      string = "UpgradeClientToAdmin"
)

Types

type AddNextCertInChain_INPUT

type AddNextCertInChain_INPUT struct {
	XMLName           xml.Name `xml:"h:AddNextCertInChain_INPUT"`
	H                 string   `xml:"xmlns:h,attr"`
	NextCertificate   string   `xml:"h:NextCertificate"`
	IsLeafCertificate bool     `xml:"h:IsLeafCertificate"`
	IsRootCertificate bool     `xml:"h:IsRootCertificate"`
}

INPUT Request Types

type AddNextCertInChain_OUTPUT

type AddNextCertInChain_OUTPUT struct {
	XMLName     xml.Name `xml:"AddNextCertInChain_OUTPUT"`
	ReturnValue ReturnValue
}

OUTPUT Response Types

type AdminPassEncryptionType

type AdminPassEncryptionType int

const (
	AdminPassEncryptionTypeNone AdminPassEncryptionType = iota
	AdminPassEncryptionTypeOther
	AdminPassEncryptionTypeHTTPDigestMD5A1
)

type AdminSetup_INPUT

type AdminSetup_INPUT struct {
	XMLName                    xml.Name `xml:"h:AdminSetup_INPUT"`
	H                          string   `xml:"xmlns:h,attr"`
	NetAdminPassEncryptionType int      `xml:"h:NetAdminPassEncryptionType"`
	NetworkAdminPassword       string   `xml:"h:NetworkAdminPassword"`
	McNonce                    string   `xml:"h:McNonce"`
	SigningAlgorithm           int      `xml:"h:SigningAlgorithm"`
	DigitalSignature           string   `xml:"h:DigitalSignature"`
}

INPUT Request Types

type AdminSetup_OUTPUT

type AdminSetup_OUTPUT struct {
	XMLName     xml.Name `xml:"AdminSetup_OUTPUT"`
	ReturnValue ReturnValue
}

OUTPUT Response Types

type AllowedControlModes

type AllowedControlModes int

const (
	AllowedControlModesNotProvisioned AllowedControlModes = iota
	AllowedControlModesClient
	AllowedControlModesAdmin
)

type Body

type Body struct {
	XMLName                     xml.Name              `xml:"Body"`
	GetResponse                 HostBasedSetupService `xml:"IPS_HostBasedSetupService"`
	EnumerateResponse           common.EnumerateResponse
	PullResponse                PullResponse
	Setup_OUTPUT                Setup_OUTPUT                `xml:"Setup_OUTPUT"`
	AdminSetup_OUTPUT           AdminSetup_OUTPUT           `xml:"AdminSetup_OUTPUT"`
	AddNextCertInChain_OUTPUT   AddNextCertInChain_OUTPUT   `xml:"AddNextCertInChain_OUTPUT"`
	UpgradeClientToAdmin_OUTPUT UpgradeClientToAdmin_OUTPUT `xml:"UpgradeClientToAdmin_OUTPUT"`
}

OUTPUT Response Types

type CertChainStatus

type CertChainStatus int

const (
	CertChainStatusNotStarted CertChainStatus = iota
	CertChainStatusChainInProgress
	CertChainStatusChainComplete
)

type CurrentControlMode

type CurrentControlMode int

const (
	NotProvisioned CurrentControlMode = iota
	Client
	Admin
)

type HostBasedSetupService

type HostBasedSetupService struct {
	XMLName                 xml.Name `xml:"IPS_HostBasedSetupService"`
	ElementName             string
	SystemCreationClassName string
	SystemName              string
	CreationClassName       string
	Name                    string
	CurrentControlMode      CurrentControlMode
	AllowedControlModes     []AllowedControlModes
	ConfigurationNonce      string
	CertChainStatus         CertChainStatus
}

OUTPUT Response Types

type PullResponse

type PullResponse struct {
	XMLName                    xml.Name                `xml:"PullResponse"`
	HostBasedSetupServiceItems []HostBasedSetupService `xml:"Items>IPS_HostBasedSetupService"`
}

OUTPUT Response Types

type Response

type Response struct {
	*client.Message
	XMLName xml.Name       `xml:"Envelope"`
	Header  message.Header `xml:"Header"`
	Body    Body           `xml:"Body"`
}

OUTPUT Response Types

func (*Response) JSON

func (r *Response) JSON() string

JSON marshals the type into JSON format

func (*Response) YAML

func (r *Response) YAML() string

YAML marshals the type into YAML format

type ReturnValue

type ReturnValue int

const (
	ReturnValueSuccess ReturnValue = iota
	ReturnValueInternalError
	ReturnValueInvalidState
	ReturnValueInvalidParam
	ReturnValueMethodDisabled
	ReturnValueAuthFailed
	ReturnValueFlashWriteLimitExceeded
)

type Service

type Service struct {
	// contains filtered or unexported fields
}

func NewHostBasedSetupServiceWithClient

func NewHostBasedSetupServiceWithClient(wsmanMessageCreator *message.WSManMessageCreator, client client.WSMan) Service

NewHostBasedSetupService returns a new instance of the HostBasedSetupService struct.

func (Service) AddNextCertInChain

func (service Service) AddNextCertInChain(cert string, isLeaf bool, isRoot bool) (response Response, err error)

Add a certificate to the provisioning certificate chain, to be used by AdminSetup or UpgradeClientToAdmin methods.

func (Service) AdminSetup

func (service Service) AdminSetup(adminPassEncryptionType AdminPassEncryptionType, digestRealm string, adminPassword string, mcNonce string, signingAlgorithm SigningAlgorithm, digitalSignature string) (response Response, err error)

Setup Intel® AMT from the local host, resulting in Admin Setup Mode. Requires OS administrator rights, and moves Intel® AMT from "Pre Provisioned" state to "Post Provisioned" state. The control mode after this method is run will be "Admin".

func (Service) Enumerate

func (service Service) Enumerate() (response Response, err error)

Enumerate returns an enumeration context which is used in a subsequent Pull call

func (Service) Get

func (service Service) Get() (response Response, err error)

Get retrieves the representation of the instance

func (Service) Pull

func (service Service) Pull(enumerationContext string) (response Response, err error)

Pull returns the instances of this class. An enumeration context provided by the Enumerate call is used as input.

func (Service) Setup

func (service Service) Setup(adminPassEncryptionType AdminPassEncryptionType, digestRealm, adminPassword string) (response Response, err error)

func (Service) UpgradeClientToAdmin

func (service Service) UpgradeClientToAdmin(mcNonce string, signingAlgorithm SigningAlgorithm, digitalSignature string) (response Response, err error)

Upgrade Intel® AMT from Client to Admin Control Mode.

type Setup_INPUT

type Setup_INPUT struct {
	XMLName                    xml.Name `xml:"h:Setup_INPUT"`
	H                          string   `xml:"xmlns:h,attr"`
	NetAdminPassEncryptionType int      `xml:"h:NetAdminPassEncryptionType"`
	NetworkAdminPassword       string   `xml:"h:NetworkAdminPassword"`
}

INPUT Request Types

type Setup_OUTPUT

type Setup_OUTPUT struct {
	XMLName     xml.Name `xml:"Setup_OUTPUT"`
	ReturnValue ReturnValue
}

OUTPUT Response Types

type SigningAlgorithm

type SigningAlgorithm int

const (
	SigningAlgorithmNone SigningAlgorithm = iota
	SigningAlgorithmOther
	SigningAlgorithmRSASHA2256
)

type UpgradeClientToAdmin_INPUT

type UpgradeClientToAdmin_INPUT struct {
	XMLName          xml.Name `xml:"h:UpgradeClientToAdmin_INPUT"`
	H                string   `xml:"xmlns:h,attr"`
	McNonce          string   `xml:"h:McNonce"`
	SigningAlgorithm int      `xml:"h:SigningAlgorithm"`
	DigitalSignature string   `xml:"h:DigitalSignature"`
}

INPUT Request Types

type UpgradeClientToAdmin_OUTPUT

type UpgradeClientToAdmin_OUTPUT struct {
	XMLName     xml.Name `xml:"UpgradeClientToAdmin_OUTPUT"`
	ReturnValue ReturnValue
}

OUTPUT Response Types