Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add secret formats to readme #326

Merged
merged 69 commits into from
Sep 20, 2023
Merged

Conversation

TalShorSap
Copy link
Contributor

add secret formats to readme

@TalShorSap TalShorSap self-assigned this Sep 3, 2023
Copy link
Collaborator

@danielforsap danielforsap left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After UA review.

README.md Outdated
| serviceInstanceName`*` | `string` | The Kubernetes name of the service instance to bind, should be in the namespace of the binding. |
| externalName | `string` | The name for the service binding in SAP BTP, defaults to the binding `metadata.name` if not specified. |
| secretName | `string` | The name of the secret where the credentials are stored, defaults to the binding `metadata.name` if not specified. |
| secretKey | `string` | Property of the Secret object that stores service binding data (credentials) returned from the broker. It is encoded as a JSON object to support complex data structures. [Example](#formats-of-secret-objects) |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In rootKey you use 'property' while in secretRootKey we use 'key'. key is also baked in the attributes' name. And you also use it below in the format title ("Key- Value Pairs") and the description.

"...defines a name of a key in the secret object in which the service binding data (credentials) returned from the broker will be stored..."

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@TalShorSap
Part of the Secret object that stores service binding data (credentials) received from the broker. When secretKey is used, credentials are stored in the JSON format.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@danielforsap
The root key... -> The secretRootKey is the key in the secret object in which... (value is json)

README.md Outdated Show resolved Hide resolved
README.md Outdated
```

### Credentials as JSON Object
To show credentials returned from the broker as a JSON object, add 'secretKey: your-secret-value' to the binding spec.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it shoud be clearer that 'your-secret-value' is a sample value.
"add 'secretKey: your-secret-value' to the binding spec" seems like straight forward instruction to follow.

"...specify your desired key name in add 'secretKey' attribute in the binding spec"

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To show credentials returned from the broker as a JSON object, specify your desired key name for 'secretKey' attribute in the binding spec. 'secretKey: your-desired-key-name'

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@danielforsap need to add reason and take care for Avi's comment

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@danielforsap danielforsap merged commit b83f523 into main Sep 20, 2023
4 checks passed
@danielforsap danielforsap deleted the add_to_readme_secret_formats branch September 20, 2023 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants