{"id":1616,"date":"2026-09-14T10:18:50","date_gmt":"2026-09-14T13:18:50","guid":{"rendered":"https:\/\/www.linuxpro.com.br\/?p=1616"},"modified":"2026-10-07T08:30:09","modified_gmt":"2026-10-07T11:30:09","slug":"api-do-virtualbox-em-go-liste-vms-com-soap","status":"publish","type":"post","link":"https:\/\/www.linuxpro.com.br\/en\/2026\/09\/api-do-virtualbox-em-go-liste-vms-com-soap\/","title":{"rendered":"VirtualBox API \u2014 part 2: SOAP client in Go"},"content":{"rendered":"

\"Mascote<\/p>\n

Vamos implementar um cliente em Go que autentica no web service do VirtualBox, lista UUID, nome e estado das m\u00e1quinas e encerra a sess\u00e3o. O programa utiliza somente a biblioteca padr\u00e3o e produz um invent\u00e1rio JSON, sem executar a\u00e7\u00f5es de escrita sobre as VMs.<\/p>\n

Esta \u00e9 a parte 2<\/strong>. Se voc\u00ea ainda n\u00e3o conhece o servi\u00e7o, leia primeiro a parte 1: SOAP, sess\u00f5es e seguran\u00e7a na API do VirtualBox<\/a>. L\u00e1 est\u00e3o a prepara\u00e7\u00e3o do vboxwebsrv<\/code>, o t\u00fanel SSH e a diferen\u00e7a entre refer\u00eancias e UUIDs.<\/p>\n

Pr\u00e9-requisitos do exemplo<\/h2>\n

Tenha Go instalado e um host VirtualBox com vboxwebsrv<\/code> ativo, autentica\u00e7\u00e3o configurada e acesso protegido. Os comandos abaixo usam http:\/\/127.0.0.1:18083\/<\/code>: execute o cliente no mesmo host ou use o t\u00fanel explicado na parte 1. N\u00e3o desabilite a autentica\u00e7\u00e3o nem exponha essa porta diretamente \u00e0 internet.<\/p>\n

Qual contrato foi usado e o que foi testado<\/h2>\n

As opera\u00e7\u00f5es e seus par\u00e2metros foram conferidos no WSDL inclu\u00eddo no SDK oficial 7.2.0<\/a>, usado como refer\u00eancia documental da linha 7.2. Isso n\u00e3o \u00e9 recomenda\u00e7\u00e3o para instalar um patch antigo: use uma vers\u00e3o mantida do VirtualBox e confira o SDK correspondente ao seu ambiente.<\/p>\n

Valida\u00e7\u00e3o original:<\/strong> o c\u00f3digo foi compilado, verificado com go vet<\/code> e testado com servidor SOAP simulado e detector de corridas. Tamb\u00e9m verificamos estruturas de requisi\u00e7\u00e3o contra o XSD do SDK. N\u00e3o houve teste de uma sess\u00e3o autenticada em um host VirtualBox real. Portanto, a integra\u00e7\u00e3o precisa passar por homologa\u00e7\u00e3o no seu laborat\u00f3rio antes de uso operacional.<\/p>\n

Os testes adicionais cobriram erro SOAP, XML inv\u00e1lido, resposta excessiva, redirecionamento, cancelamento, escape de caracteres e limpeza de sess\u00e3o ap\u00f3s falha. O exemplo n\u00e3o pretende substituir um SDK completo.<\/p>\n

Revis\u00e3o de 7 de outubro de 2026:<\/strong> repetimos compila\u00e7\u00e3o, go vet<\/code> e testes com -race<\/code> usando o c\u00f3digo extra\u00eddo do artigo. Acrescentamos cancelamento por Ctrl+C, teste de invent\u00e1rio vazio com logoff e verifica\u00e7\u00f5es simuladas de ciclo completo, escape, resposta inv\u00e1lida, limite de tamanho e limpeza ap\u00f3s cancelamento. A verifica\u00e7\u00e3o original do XSD n\u00e3o foi repetida; continua sem homologa\u00e7\u00e3o autenticada em host real.<\/p>\n

Fluxo: login, invent\u00e1rio, limpeza e sa\u00edda<\/h2>\n

O cliente autentica, recebe uma refer\u00eancia remota de IVirtualBox<\/code>, solicita as refer\u00eancias das m\u00e1quinas e consulta UUID, nome e estado de cada uma. S\u00f3 depois de tentar encerrar a sess\u00e3o ele devolve o invent\u00e1rio para a sa\u00edda JSON. Uma refer\u00eancia SOAP identifica um objeto dentro do contexto remoto; n\u00e3o \u00e9 o UUID persistente da VM.<\/p>\n

\"Fluxo
As chamadas usam um endpoint protegido. A limpeza tem prazo pr\u00f3prio para continuar poss\u00edvel ap\u00f3s o cancelamento da coleta.<\/figcaption><\/figure>\n\n\n\n\n\n\n\n\n
Opera\u00e7\u00e3o<\/th>\nEntrada principal<\/th>\nResultado esperado<\/th>\n<\/tr>\n<\/thead>\n
IWebsessionManager_logon<\/code><\/td>\nUsu\u00e1rio e senha.<\/td>\nRefer\u00eancia do objeto IVirtualBox.<\/td>\n<\/tr>\n
IVirtualBox_getMachines<\/code><\/td>\n_this<\/code> com a refer\u00eancia recebida.<\/td>\nRefer\u00eancias das m\u00e1quinas, n\u00e3o seus UUIDs.<\/td>\n<\/tr>\n
IMachine_getId\/getName\/getState<\/code><\/td>\n_this<\/code> com a refer\u00eancia da m\u00e1quina.<\/td>\nUm valor por consulta.<\/td>\n<\/tr>\n
IWebsessionManager_logoff<\/code><\/td>\nrefIVirtualBox<\/code>.<\/td>\nEncerramento da sess\u00e3o remota.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Para N<\/em> m\u00e1quinas, o caminho de sucesso deste exemplo faz 3N + 3<\/code> chamadas SOAP: login, listagem, tr\u00eas atributos por VM e logoff. \u00c9 uma consequ\u00eancia do c\u00f3digo sequencial abaixo, n\u00e3o um requisito de todos os clientes VirtualBox. Quanto maior o invent\u00e1rio, mais importante medir lat\u00eancia e prazo total.<\/p>\n

1. Criar o projeto Go<\/h2>\n
mkdir vbox-inventory\ncd vbox-inventory\ngo mod init example.com\/vbox-inventory<\/code><\/pre>\n
O exemplo utiliza errors.Join<\/code>, dispon\u00edvel a partir do Go 1.20; prefira uma vers\u00e3o atualmente mantida. N\u00e3o h\u00e1 depend\u00eancias externas para baixar. Vamos separar o transporte SOAP em client.go<\/code> e o invent\u00e1rio em main.go<\/code>.<\/p>\n
2. Implementar o transporte SOAP<\/h2>\n
Salve como client.go<\/code>. O cliente aceita HTTP apenas para loopback, n\u00e3o segue redirecionamentos, limita a resposta e deixa a valida\u00e7\u00e3o TLS padr\u00e3o ativa:<\/p>\n
package main\n\nimport (\n\t"bytes"\n\t"context"\n\t"encoding\/xml"\n\t"errors"\n\t"fmt"\n\t"io"\n\t"net"\n\t"net\/http"\n\t"net\/url"\n\t"time"\n)\n\nconst apiNS = "http:\/\/www.virtualbox.org\/"\nconst soapNS = "http:\/\/schemas.xmlsoap.org\/soap\/envelope\/"\nconst maxResponse = 2 << 20\n\ntype client struct {\n\tendpoint string\n\thttp     *http.Client\n}\n\ntype field struct{ name, value string }\n\ntype reply struct {\n\tXMLName xml.Name `xml:"http:\/\/schemas.xmlsoap.org\/soap\/envelope\/ Envelope"`\n\tBody    struct {\n\t\tFault  *struct{} `xml:"http:\/\/schemas.xmlsoap.org\/soap\/envelope\/ Fault"`\n\t\tResult struct {\n\t\t\tXMLName xml.Name\n\t\t\tValues  []string `xml:"returnval"`\n\t\t} `xml:",any"`\n\t} `xml:"http:\/\/schemas.xmlsoap.org\/soap\/envelope\/ Body"`\n}\n\nfunc newClient(endpoint string) (*client, error) {\n\tu, err := url.Parse(endpoint)\n\tif err != nil || u.Host == "" || u.User != nil || u.RawQuery != "" || u.Fragment != "" {\n\t\treturn nil, errors.New("endpoint inv\u00e1lido: use URL sem credenciais ou par\u00e2metros")\n\t}\n\tip := net.ParseIP(u.Hostname())\n\tloopback := u.Hostname() == "localhost" || (ip != nil && ip.IsLoopback())\n\tif u.Scheme != "https" && !(u.Scheme == "http" && loopback) {\n\t\treturn nil, errors.New("use HTTPS; HTTP s\u00f3 \u00e9 permitido no loopback")\n\t}\n\ttransport := http.DefaultTransport.(*http.Transport).Clone()\n\ttransport.Proxy = nil \/\/ N\u00e3o encaminhar credenciais por proxy do ambiente.\n\treturn &client{\n\t\tendpoint: endpoint,\n\t\thttp: &http.Client{\n\t\t\tTransport:     transport,\n\t\t\tTimeout:       10 * time.Second,\n\t\t\tCheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse },\n\t\t},\n\t}, nil\n}\n\nfunc (c *client) call(ctx context.Context, method string, fields ...field) (values []string, err error) {\n\tswitch method {\n\tcase "IWebsessionManager_logon", "IWebsessionManager_logoff", "IVirtualBox_getMachines",\n\t\t"IMachine_getId", "IMachine_getName", "IMachine_getState":\n\tdefault:\n\t\treturn nil, errors.New("opera\u00e7\u00e3o fora do escopo somente leitura")\n\t}\n\tvar params bytes.Buffer\n\tenc := xml.NewEncoder(&params)\n\tfor _, f := range fields {\n\t\tif err := enc.EncodeElement(f.value, xml.StartElement{Name: xml.Name{Local: f.name}}); err != nil {\n\t\t\treturn nil, fmt.Errorf("codificar par\u00e2metros: %w", err)\n\t\t}\n\t}\n\tif err := enc.Flush(); err != nil {\n\t\treturn nil, fmt.Errorf("finalizar XML: %w", err)\n\t}\n\tbody := fmt.Sprintf(\n\t\t`<s:Envelope xmlns:s="%s" xmlns:v="%s"><s:Body><v:%s>%s<\/v:%s><\/s:Body><\/s:Envelope>`,\n\t\tsoapNS, apiNS, method, params.String(), method,\n\t)\n\treq, err := http.NewRequestWithContext(ctx, http.MethodPost, c.endpoint, bytes.NewBufferString(body))\n\tif err != nil {\n\t\treturn nil, fmt.Errorf("criar requisi\u00e7\u00e3o: %w", err)\n\t}\n\treq.Header.Set("Content-Type", "text\/xml; charset=utf-8")\n\treq.Header.Set("SOAPAction", `""`)\n\tres, err := c.http.Do(req)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf("transportar %s: %w", method, err)\n\t}\n\tdefer func() { err = errors.Join(err, res.Body.Close()) }()\n\tdata, err := io.ReadAll(io.LimitReader(res.Body, maxResponse+1))\n\tif err != nil {\n\t\treturn nil, fmt.Errorf("ler resposta: %w", err)\n\t}\n\tif len(data) > maxResponse {\n\t\treturn nil, errors.New("resposta excede 2 MiB")\n\t}\n\tvar decoded reply\n\tdecodeErr := xml.Unmarshal(data, &decoded)\n\tif decodeErr == nil && decoded.Body.Fault != nil {\n\t\t\/\/ N\u00e3o imprimir faultstring\/detail: podem revelar informa\u00e7\u00f5es do host.\n\t\treturn nil, fmt.Errorf("falha SOAP em %s (HTTP %d)", method, res.StatusCode)\n\t}\n\tif res.StatusCode != http.StatusOK {\n\t\treturn nil, fmt.Errorf("%s: HTTP %d", method, res.StatusCode)\n\t}\n\tif decodeErr != nil {\n\t\treturn nil, fmt.Errorf("decodificar resposta: %w", decodeErr)\n\t}\n\tresult := decoded.Body.Result\n\tif result.XMLName.Space != apiNS || result.XMLName.Local != method+"Response" {\n\t\treturn nil, errors.New("resposta SOAP inesperada")\n\t}\n\treturn result.Values, nil\n}\n\nfunc (c *client) one(ctx context.Context, method string, fields ...field) (string, error) {\n\tvalues, err := c.call(ctx, method, fields...)\n\tif err != nil {\n\t\treturn "", err\n\t}\n\tif len(values) != 1 || values[0] == "" {\n\t\treturn "", errors.New("retorno escalar vazio ou inv\u00e1lido")\n\t}\n\treturn values[0], nil\n}<\/code><\/pre>\n
O xml.Encoder<\/code> cuida do escape dos valores. N\u00e3o concatenamos a senha diretamente como XML. O namespace, as opera\u00e7\u00f5es e o SOAPAction<\/code> vazio seguem o contrato consultado; erros HTTP e SOAP s\u00e3o tratados separadamente.<\/p>\n
Detalhes completos de falhas do servidor foram omitidos da mensagem para reduzir exposi\u00e7\u00e3o de informa\u00e7\u00f5es. Em um produto real, voc\u00ea pode classificar os tipos de falha internamente, mantendo segredos e detalhes sens\u00edveis fora dos logs. Veja as refer\u00eancias de encoding\/xml<\/a> e net\/http<\/a>.<\/p>\n
3. Listar as m\u00e1quinas e tentar encerrar a sess\u00e3o<\/h2>\n
Salve como main.go<\/code>:<\/p>\n
package main\n\nimport (\n\t"context"\n\t"encoding\/json"\n\t"errors"\n\t"fmt"\n\t"os"\n\t"os\/signal"\n\t"time"\n)\n\ntype machine struct {\n\tID    string `json:"id"`\n\tName  string `json:"name"`\n\tState string `json:"state"`\n}\n\nfunc inventory(ctx context.Context, c *client, username, password string) (vms []machine, err error) {\n\tref, err := c.one(ctx, "IWebsessionManager_logon",\n\t\tfield{name: "username", value: username},\n\t\tfield{name: "password", value: password},\n\t)\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\tdefer func() {\n\t\t\/\/ A limpeza precisa funcionar mesmo se o contexto principal expirar.\n\t\tcleanup, cancel := context.WithTimeout(context.Background(), 5*time.Second)\n\t\tdefer cancel()\n\t\t_, closeErr := c.call(cleanup, "IWebsessionManager_logoff", field{name: "refIVirtualBox", value: ref})\n\t\tif closeErr != nil {\n\t\t\terr = errors.Join(err, fmt.Errorf("encerrar sess\u00e3o: %w", closeErr))\n\t\t}\n\t}()\n\trefs, err := c.call(ctx, "IVirtualBox_getMachines", field{name: "_this", value: ref})\n\tif err != nil {\n\t\treturn nil, err\n\t}\n\tvms = make([]machine, 0, len(refs))\n\tfor _, machineRef := range refs {\n\t\ttarget := field{name: "_this", value: machineRef}\n\t\tid, err := c.one(ctx, "IMachine_getId", target)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t\tname, err := c.one(ctx, "IMachine_getName", target)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t\tstate, err := c.one(ctx, "IMachine_getState", target)\n\t\tif err != nil {\n\t\t\treturn nil, err\n\t\t}\n\t\tvms = append(vms, machine{ID: id, Name: name, State: state})\n\t}\n\treturn vms, nil\n}\n\nfunc run() error {\n\tendpoint := os.Getenv("VBOX_URL")\n\tif endpoint == "" {\n\t\tendpoint = "http:\/\/127.0.0.1:18083\/"\n\t}\n\tusername, password := os.Getenv("VBOX_USER"), os.Getenv("VBOX_PASSWORD")\n\tif username == "" || password == "" {\n\t\treturn errors.New("defina VBOX_USER e VBOX_PASSWORD")\n\t}\n\tc, err := newClient(endpoint)\n\tif err != nil {\n\t\treturn err\n\t}\n\tdefer c.http.CloseIdleConnections()\n\tshutdown, stop := signal.NotifyContext(context.Background(), os.Interrupt)\n\tdefer stop()\n\tctx, cancel := context.WithTimeout(shutdown, 30*time.Second)\n\tdefer cancel()\n\tvms, err := inventory(ctx, c, username, password)\n\tif err != nil {\n\t\treturn err\n\t}\n\tout := json.NewEncoder(os.Stdout)\n\tout.SetIndent("", "  ")\n\tif err := out.Encode(vms); err != nil {\n\t\treturn fmt.Errorf("escrever invent\u00e1rio: %w", err)\n\t}\n\treturn nil\n}\n\nfunc main() {\n\tif err := run(); err != nil {\n\t\tfmt.Fprintln(os.Stderr, "erro:", err)\n\t\tos.Exit(1)\n\t}\n}\n<\/code><\/pre>\n
O defer<\/code> para limpeza \u00e9 registrado assim que o login retorna uma refer\u00eancia v\u00e1lida. Ele usa um contexto independente e curto: se a consulta principal expirar, ainda haver\u00e1 uma tentativa de encerrar a sess\u00e3o. Uma falha no logoff n\u00e3o \u00e9 silenciosamente descartada. O tratamento de interrup\u00e7\u00e3o usa signal.NotifyContext<\/a>, da biblioteca padr\u00e3o.<\/p>\n
A execu\u00e7\u00e3o \u00e9 sequencial por clareza. O nome, estado e UUID exigem consultas separadas; n\u00e3o \u00e9 um coletor otimizado para invent\u00e1rios enormes. O programa interrompe a coleta no primeiro erro e n\u00e3o apresenta um invent\u00e1rio parcial como se fosse completo. A restri\u00e7\u00e3o de opera\u00e7\u00f5es \u00e9 do cliente did\u00e1tico, n\u00e3o uma pol\u00edtica de autoriza\u00e7\u00e3o aplicada pelo servidor.<\/p>\n
O que a limpeza garante \u2014 e o que ela n\u00e3o garante<\/h3>\n
O contexto da coleta agora observa os.Interrupt<\/code>: Ctrl+C pede cancelamento e permite que a fun\u00e7\u00e3o retorne passando pelo defer<\/code>. A limpeza ainda pode consumir at\u00e9 cinco segundos adicionais. Somente Ctrl+C\/SIGINT foi registrado: SIGTERM n\u00e3o recebe esse tratamento cooperativo no exemplo. Isso tamb\u00e9m n\u00e3o cobre encerramento for\u00e7ado do processo, queda da m\u00e1quina ou perda de comunica\u00e7\u00e3o com o servi\u00e7o.<\/p>\n
Se o servidor aceitar o login, mas a resposta se perder antes de o cliente receber a refer\u00eancia, o programa n\u00e3o ter\u00e1 como executar esse logoff. A expira\u00e7\u00e3o de sess\u00f5es do servi\u00e7o continua importante. Por outro lado, se o logoff falhar depois de uma coleta completa, esta implementa\u00e7\u00e3o retorna erro e n\u00e3o imprime JSON de sucesso: uma decis\u00e3o conservadora, documentada, n\u00e3o prova de que a sess\u00e3o remota permaneceu aberta.<\/p>\n
\u201cSomente leitura\u201d descreve as a\u00e7\u00f5es sobre VMs: autenticar e encerrar a sess\u00e3o ainda alteram o estado administrativo do web service. O programa n\u00e3o solicita bloqueio de m\u00e1quina, n\u00e3o inicia VMs e n\u00e3o modifica discos. A conta de servi\u00e7o, por\u00e9m, pode possuir mais permiss\u00f5es que o cliente utiliza; a lista permitida de m\u00e9todos n\u00e3o substitui isolamento e autoriza\u00e7\u00e3o no ambiente.<\/p>\n
4. Compilar e executar sem colocar a senha no hist\u00f3rico<\/h2>\n
No Bash, compile e leia a senha sem escrev\u00ea-la na linha de comando:<\/p>\n
gofmt -w client.go main.go\ngo vet .\/...\ngo build -o vbox-inventory .\n\nexport VBOX_URL='http:\/\/127.0.0.1:18083\/'\nIFS= read -r -p 'Usu\u00e1rio do servi\u00e7o: ' VBOX_USER\nexport VBOX_USER\nIFS= read -r -s -p 'Senha do servi\u00e7o: ' VBOX_PASSWORD\nprintf '\\n'\nexport VBOX_PASSWORD\n.\/vbox-inventory\nunset VBOX_PASSWORD<\/code><\/pre>\n
Vari\u00e1veis de ambiente n\u00e3o s\u00e3o um cofre: processos privilegiados e ferramentas de diagn\u00f3stico podem exp\u00f4-las. Em automa\u00e7\u00e3o, integre um mecanismo de segredos apropriado e n\u00e3o imprima ambiente, XML de login ou refer\u00eancias de sess\u00e3o.<\/p>\n
Formato ilustrativo de sa\u00edda, n\u00e3o capturado de um host real:<\/p>\n
[\n  {\n    "id": "11111111-2222-3333-4444-555555555555",\n    "name": "Linux lab",\n    "state": "PoweredOff"\n  }\n]<\/code><\/pre>\n
Se a conta n\u00e3o tiver m\u00e1quinas registradas, a sa\u00edda ser\u00e1 []<\/code>. Um erro faz o programa terminar com c\u00f3digo diferente de zero. Antes de concluir que o invent\u00e1rio est\u00e1 errado, confirme qual ambiente de usu\u00e1rio o servi\u00e7o est\u00e1 expondo.<\/p>\n
5. Um teste automatizado sem hipervisor<\/h2>\n
Salve este teste como client_test.go<\/code>. Ele verifica que um SOAP Fault produz erro sem reproduzir os detalhes privados do servidor:<\/p>\n
package main\n\nimport (\n\t"context"\n\t"io"\n\t"net\/http"\n\t"net\/http\/httptest"\n\t"strings"\n\t"testing"\n)\n\nfunc TestSOAPFaultIsNotSuccess(t *testing.T) {\n\tserver := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tw.WriteHeader(http.StatusInternalServerError)\n\t\tbody := `<s:Envelope xmlns:s="http:\/\/schemas.xmlsoap.org\/soap\/envelope\/">` +\n\t\t\t`<s:Body><s:Fault><faultstring>private-host-detail<\/faultstring><\/s:Fault><\/s:Body><\/s:Envelope>`\n\t\tif _, err := io.WriteString(w, body); err != nil {\n\t\t\tt.Error(err)\n\t\t}\n\t}))\n\tdefer server.Close()\n\tc, err := newClient(server.URL)\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\tdefer c.http.CloseIdleConnections()\n\t_, err = c.call(context.Background(), "IVirtualBox_getMachines", field{name: "_this", value: "test-ref"})\n\tif err == nil {\n\t\tt.Fatal("SOAP Fault deveria produzir erro")\n\t}\n\tif strings.Contains(err.Error(), "private-host-detail") {\n\t\tt.Fatal("erro exp\u00f4s detalhes do host")\n\t}\n}<\/code><\/pre>\n
go test -race -count=1 .\/...<\/code><\/pre>\n
Esse teste exercita o transporte com um servidor simulado. Ele n\u00e3o comprova credenciais, permiss\u00f5es ou compatibilidade operacional com seu VirtualBox. Complete a homologa\u00e7\u00e3o com uma m\u00e1quina de laborat\u00f3rio e compare UUID, nome e estado com a administra\u00e7\u00e3o local.<\/p>\n
Teste tamb\u00e9m invent\u00e1rio vazio e encerramento<\/h3>\n
Salve o teste abaixo como empty_test.go<\/code>, ao lado dos demais arquivos, e repita go test -race -count=1 .\/...<\/code>. Ele exige sa\u00edda serializada como lista vazia e confirma\u00e7\u00e3o de que o cliente tentou o logoff:<\/p>\n
package main\n\nimport (\n\t"context"\n\t"encoding\/json"\n\t"encoding\/xml"\n\t"fmt"\n\t"io"\n\t"net\/http"\n\t"net\/http\/httptest"\n\t"sync\/atomic"\n\t"testing"\n)\n\nfunc TestEmptyInventoryLogsOff(t *testing.T) {\n\tvar loggedOff atomic.Bool\n\tserver := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tvar req struct {\n\t\t\tBody struct {\n\t\t\t\tMethod struct{ XMLName xml.Name } `xml:",any"`\n\t\t\t} `xml:"Body"`\n\t\t}\n\t\tif err := xml.NewDecoder(r.Body).Decode(&req); err != nil {\n\t\t\tt.Error(err)\n\t\t\tw.WriteHeader(http.StatusBadRequest)\n\t\t\treturn\n\t\t}\n\t\tmethod := req.Body.Method.XMLName.Local\n\t\tvalue := ""\n\t\tswitch method {\n\t\tcase "IWebsessionManager_logon":\n\t\t\tvalue = "<returnval>test-session<\/returnval>"\n\t\tcase "IVirtualBox_getMachines":\n\t\tcase "IWebsessionManager_logoff":\n\t\t\tloggedOff.Store(true)\n\t\tdefault:\n\t\t\tt.Errorf("opera\u00e7\u00e3o inesperada: %s", method)\n\t\t}\n\t\tbody := fmt.Sprintf(\n\t\t\t`<s:Envelope xmlns:s="%s"><s:Body><v:%sResponse xmlns:v="%s">%s<\/v:%sResponse><\/s:Body><\/s:Envelope>`,\n\t\t\tsoapNS, method, apiNS, value, method,\n\t\t)\n\t\tif _, err := io.WriteString(w, body); err != nil {\n\t\t\tt.Error(err)\n\t\t}\n\t}))\n\tdefer server.Close()\n\tc, err := newClient(server.URL)\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\tdefer c.http.CloseIdleConnections()\n\tvms, err := inventory(context.Background(), c, "lab-user", "lab-password")\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\tdata, err := json.Marshal(vms)\n\tif err != nil {\n\t\tt.Fatal(err)\n\t}\n\tif string(data) != "[]" || !loggedOff.Load() {\n\t\tt.Fatalf("invent\u00e1rio=%s; logoff=%v", data, loggedOff.Load())\n\t}\n}\n<\/code><\/pre>\n
Homologa\u00e7\u00e3o em host real: roteiro de aceita\u00e7\u00e3o<\/h2>\n
    \n
  1. Registre vers\u00e3o do VirtualBox, SDK usado como contrato, configura\u00e7\u00e3o do servi\u00e7o e conta sob a qual ele roda.<\/li>\n
  2. Use um endpoint protegido do laborat\u00f3rio, com autentica\u00e7\u00e3o ativa. N\u00e3o reutilize credenciais de produ\u00e7\u00e3o em fixtures.<\/li>\n
  3. Compare os UUIDs com VBoxManage list vms<\/code> executado no mesmo contexto de usu\u00e1rio do servi\u00e7o. Consulte estados por VBoxManage showvminfo UUID --machinereadable<\/code>, substituindo UUID pelo identificador real.<\/li>\n
  4. Teste lista vazia, nomes com acentos e caracteres XML, credencial inv\u00e1lida, cancelamento e indisponibilidade.<\/li>\n
  5. Confirme que o programa s\u00f3 consulta atributos e que nenhum comando de escrita foi acrescentado ao adaptador.<\/li>\n
  6. Documente as falhas e os limites encontrados antes de usar o invent\u00e1rio em automa\u00e7\u00e3o.<\/li>\n<\/ol>\n
    O invent\u00e1rio n\u00e3o \u00e9 uma fotografia at\u00f4mica: uma VM pode mudar de estado entre consultas. A ordem da lista tamb\u00e9m n\u00e3o deve ser tratada como contrato. Para compara\u00e7\u00e3o automatizada, use UUID como chave e aceite que estados podem mudar durante a coleta.<\/p>\n
    Falhas comuns e diagn\u00f3stico<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n
    Problema<\/th>\nO que verificar<\/th>\n<\/tr>\n<\/thead>\n
    Conex\u00e3o recusada<\/td>\nServi\u00e7o ativo, endere\u00e7o, porta e t\u00fanel SSH.<\/td>\n<\/tr>\n
    Falha SOAP no login<\/td>\nAutentica\u00e7\u00e3o configurada, usu\u00e1rio e senha; n\u00e3o desligue a prote\u00e7\u00e3o como corre\u00e7\u00e3o.<\/td>\n<\/tr>\n
    Lista vazia<\/td>\nUsu\u00e1rio que executa o servi\u00e7o e m\u00e1quinas registradas naquele ambiente.<\/td>\n<\/tr>\n
    Refer\u00eancia inv\u00e1lida<\/td>\nSess\u00e3o expirada ou refer\u00eancia reutilizada de outra execu\u00e7\u00e3o.<\/td>\n<\/tr>\n
    Erro de certificado<\/td>\nNome do servidor e cadeia de confian\u00e7a; n\u00e3o use InsecureSkipVerify<\/code>.<\/td>\n<\/tr>\n
    Resposta inesperada<\/td>\nEndpoint correto, namespace, vers\u00e3o e contrato WSDL.<\/td>\n<\/tr>\n
    Prazo excedido<\/td>\nLat\u00eancia, n\u00famero de VMs e limites configurados.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    O programa utiliza dez segundos por requisi\u00e7\u00e3o, trinta para a coleta e cinco para a limpeza. S\u00e3o escolhas did\u00e1ticas, n\u00e3o valores universais. Ajuste-os com medi\u00e7\u00e3o. N\u00e3o acrescente repeti\u00e7\u00e3o autom\u00e1tica indiscriminada quando evoluir para a\u00e7\u00f5es de escrita: um timeout n\u00e3o prova que o servidor deixou de executar a opera\u00e7\u00e3o.<\/p>\n
    Quer evoluir de consultas para a\u00e7\u00f5es sobre as VMs? Revise na parte 1<\/a> os cuidados com sess\u00f5es de m\u00e1quina, bloqueios, autoriza\u00e7\u00e3o e opera\u00e7\u00f5es de escrita.<\/p>\n
    Como transformar o exemplo em um projeto maior<\/h2>\n