[CC-30333] auth: use JWT for authentication

[pritesh-lahoti]

This PR allows using the Terraform Provider via JWT authentication, in addition to API Keys. The JWT auth mechanism requires a CC_VANITY_NAME env capturing the vanity name of the org with the corresponding JWT Issuer. In case the JWT is issued against multiple identities, it also requires a CC_USERNAME env capturing the user / service account to impersonate. Eventually, we will add a CI stage for running acceptance tests via this auth mechanism.

Commit checklist

• Changelog
• Doc gen (make generate)
• Integration test(s)
• Acceptance test(s)
• Example(s)

[kathancox]

lgtm

[pritesh-lahoti]

lgtm

@kathancox, requesting another round of review, as there have been further changes to the docs. Thank you!

[fantapop]

This one seems a bit off, but lets fix the message in another round. We can fix later. It's talking about both JWT Issuer and Invalid API key.

    jwt_issuers_test.go:148: Step 1/3 error: Error running apply: exit status 1

        Error: Error creating JWT Issuer

          with cockroach_jwt_issuer.test,
          on terraform_plugin_test.tf line 12, in resource "cockroach_jwt_issuer" "test":
          12: resource "cockroach_jwt_issuer" "test" {

        Could not create JWT Issuer: invalid API key
--- FAIL: TestAccJWTIssuerResource (0.34s)

[fantapop]

this looks great. Thank you. I mentioned one nit but we can wait to the next version to fix.

[fantapop]

@pritesh-lahoti i just noticed the commit message needs to be updated with the new env var names.

[kathancox]

Two nits, but LGTM!

[kathancox]

Suggested change

	# The Terraform provider requires either COCKROACH_API_KEY or COCKROACH_API_JWT environment variable for performing authentication.
	# The Terraform provider requires either the COCKROACH_API_KEY or COCKROACH_API_JWT environment variable for performing authentication.

[kathancox]

Suggested change

	# The Terraform provider requires either COCKROACH_API_KEY or COCKROACH_API_JWT environment variable for performing authentication.
	# The Terraform provider requires either the COCKROACH_API_KEY or COCKROACH_API_JWT environment variable for performing authentication.

[fantapop]

I'm going to go ahead and make these small nit changes and land the PR. There is still time to get the release out.