Skip to content

Commit

Permalink
Merge branch 'main' into franziskus/update-readme
Browse files Browse the repository at this point in the history
  • Loading branch information
franziskuskiefer authored Nov 8, 2024
2 parents 392ec97 + 031c9ad commit ecc6c84
Show file tree
Hide file tree
Showing 2 changed files with 5 additions and 6 deletions.
9 changes: 4 additions & 5 deletions book/src/user_manual/credential_validation.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
# Credential validation

Credential validation is a process that allows a member to verify the validity
of the credentials of other members in the group. The process is described in
detail in the [MLS protocol
specification](https://messaginglayersecurity.rocks/mls-protocol/draft-ietf-mls-protocol.html#name-credential-validation).
of the credentials of other members in the group. The process is described in
detail in the [MLS protocol specification](https://www.rfc-editor.org/rfc/rfc9420.html#name-credential-validation).

In practice, the application should check the validity of the credentials of
other members in two instances:

- When joining a new group (by looking at the ratchet tree)
- When [processing messages](./processing.md) (by looking at a add & update proposals of a StagedCommit)
- When joining a new group (by looking at the ratchet tree)
- When [processing messages](./processing.md) (by looking at a add & update proposals of a StagedCommit)
2 changes: 1 addition & 1 deletion book/src/user_manual/custom_proposals.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

OpenMLS allows the creation and use of application-defined proposals. To create such a proposal, the application needs to define a Proposal Type in such a way that its value doesn't collide with any Proposal Types defined in Section 17.4. of RFC 9420. If the proposal is meant to be used only inside of a particular application, the value of the Proposal Type is recommended to be in the range between `0xF000` and `0xFFFF`, as that range is reserved for private use.

Custom proposals can contain arbitrary octet-strings as defined by the application. Any policy decisions based on custom proposals will have to be made by the application, such as the decision to include a given custom proposal in a commit, or whether to accept a commit that includes one or more custom proposals. To decide the latter, applications can inspect the queued proposals in a `ProcessedMessageContent::StagedCommitMesage(staged_commit)`.
Custom proposals can contain arbitrary octet-strings as defined by the application. Any policy decisions based on custom proposals will have to be made by the application, such as the decision to include a given custom proposal in a commit, or whether to accept a commit that includes one or more custom proposals. To decide the latter, applications can inspect the queued proposals in a `ProcessedMessageContent::StagedCommitMessage(staged_commit)`.

Example on how to use custom proposals:

Expand Down

0 comments on commit ecc6c84

Please sign in to comment.