github.com/vmware/go-vcloud-director/v2@v2.24.0/samples/saml_auth_adfs/README.md (about)

     1  # SAML authentication with ADFS as IdP
     2  This is an example how to use Active Directory Federation Services as SAML IdP for vCD.
     3  `main()` function has an example how to setup vCD client with SAML auth. On successful login it will
     4  list Edge Gateways.
     5  To run this command please supply parameters as per below example:
     6  ```
     7  go build -o auth
     8  ./auth --username test@test-forest.net --password my-password --org my-org --endpoint https://_YOUR_HOSTNAME_/api
     9  ```
    10  
    11  Results should look similar to:
    12  ```
    13  Found 1 Edge Gateways
    14  my-edge-gw
    15  ```
    16  
    17  
    18  ## More details
    19  Main trick for making SAML with ADFS work is to use configuration option function
    20  `WithSamlAdfs(useSaml bool, customAdfsRptId string)` in `govcd.NewVCDClient()`.
    21  At the moment ADFS WS-TRUST endpoint "/adfs/services/trust/13/usernamemixed" is the only one
    22  supported and it must be enabled on ADFS server to work properly.
    23  
    24  ## Troubleshooting
    25  Environment variable `GOVCD_LOG=1` can be used to enable API call logging. It should log all API
    26  calls (including the ones to ADFS server) with obfuscated credentials to aid troubleshooting.