Skip to content

Commit

Permalink
Merge remote-tracking branch 'upstream/main'
Browse files Browse the repository at this point in the history
  • Loading branch information
henkvancann committed Jan 10, 2024
2 parents 115cab4 + 9331ca0 commit 3476b10
Show file tree
Hide file tree
Showing 23 changed files with 1,196 additions and 1,200 deletions.
4 changes: 2 additions & 2 deletions docs/02_overview/overview-and-context.mdx

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/04_glossary/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@
# .gitignore
# .gitignore
# .gitignore
# .gitignore
.history
.safe_history
3 changes: 0 additions & 3 deletions docs/04_glossary/AN.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/04_glossary/Home.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ There are a few [practical rules](https://wiki.trustoverip.org/display/HOME/Term

### KERISSE reads this wiki

The _weboftrust_ wiki glossary is currently our input tool for our KERI Suite glossary. However, we regularly scrape the wiki into [KERISSE](kerisse.org), we add features and metadata, we connect relevant matching terms from related glossaries and finally we index it for the KERI Suite Search Engine (KERISSE).
The _weboftrust_ wiki glossary is currently our input tool for our KERI Suite glossary. However, we regularly scrape the wiki into [KERISSE](http://kerisse.org), we add features and metadata, we connect relevant matching terms from related glossaries and finally we index it for the KERI Suite Search Engine (KERISSE).

_Have fun CRU-ing!_
'* CRU=Create Read Update
8 changes: 7 additions & 1 deletion docs/04_glossary/first-seen.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
# first seen
## Definition

"First seen" in KERI is the first verified event, accepted in the KEL. It has no effect on the timing of what has arrived in escrow for example; in escrow there can be garbage. Every 'first seen' event is propagated world wide within micro-seconds to the watchers. Only in this microseconds windows that you could have a live key conprise attack. If that happens, this where you have to look after this duplicity-attack a bit more in depth to handle it safely. E.g. a valid key rotation.
A "First seen" event in KERI refers to the first event received by validator such as a witness and that is valid and fits the available tail sequence number in the validator's KEL, and therefore is accepted into the validator's KEL. This rule has no effect on the timing of what has arrived in escrow for example; in escrow there can be garbage. Assuming a watched set of validators agree on the first-seen events and thus also agree on the KELs, the watchers of those validators will propagate only those first-seen events within microseconds.

## The rule
From the perspective of a validator, the rule is "First seen, always seen, never unseen".

## Key Compromise, Duplicity, and Recovery
Different validators might have a different _first-seen_ number for the same originating transaction event. In the case of duplicitous (inconsistent) interaction events originating from the controller (of the current signing key(s)), which might not be discovered until after a key rotation, a recovery process involving judges and jury may be triggered. More [here](https://trustoverip.github.io/tswg-keri-specification/#superseding-rules-for-recovery-at-a-given-location-sn-sequence-number). Validators will not provide an outdated KEL or Event once an erroneous KEL has been corrected.
2 changes: 1 addition & 1 deletion docs/04_glossary/keridemlia.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# keridemlia
## Definition

It is a contraction of [KERI](key-event-receipt-infratructure) and [Kademlia](https://en.wikipedia.org/wiki/Kademlia). It's the distributed database of Witness IP-addresses based on a [Distributed Hash Table](distributed-hash-table). It also does the CNAME - stuff that [Domain Name](domain-name) Services (DNS) offers for KERI: the mapping between an identifier and it's controller AID stored in the KEL to its current wittness AID and the wittness AID to the IP address.
It is a contraction of [KERI](key-event-receipt-infrastructure) and [Kademlia](https://en.wikipedia.org/wiki/Kademlia). It's the distributed database of Witness IP-addresses based on a [Distributed Hash Table](distributed-hash-table). It also does the CNAME - stuff that [Domain Name](domain-name) Services (DNS) offers for KERI: the mapping between an identifier and it's controller AID stored in the KEL to its current wittness AID and the wittness AID to the IP address.
(@henkvancann)
2 changes: 1 addition & 1 deletion docs/04_glossary/non-interactive-authentication-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ A group of approaches having non-interactive mechanisms that pose unique problem
More in [source](https://hackmd.io/ZbVAbNK1SPyT90-oNwN_cw) Keri Request Authentication Mechanism (KRAM) by Samuel Smith

## Related
[Interactive authentication design](Interactive-authentication-design)
[Interactive authentication design](interactive-authentication-design)
4 changes: 4 additions & 0 deletions docs/04_glossary/party.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# party
## Definition
An entity who participates or is concerned in an action, proceeding, plan, etc.
Source: ToIP
2 changes: 1 addition & 1 deletion docs/04_glossary/threshold-structure-security.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
A threshold structure for security allows for weaker key management or execution environment infrastructure individually, but achieve greater overall security by multiplying the number of attack surfaces that an attacker must overcome to compromise a system.
In other words, with threshold structures, overall security may be greater than the security of any of the individual parts.

For example, in [MFA](mutli-factor-authentication) the combination of two factors, something you have and something you know, may be much more secure than either of the factors by themselves.
For example, in [MFA](multi-factor-authentication) the combination of two factors, something you have and something you know, may be much more secure than either of the factors by themselves.

### Threshold Structure Security vs. TEE Security
Threshold structures may be employed in a complementary manner to trusted execution environments ([TEE](trusted-execution-environment)) for security. The two types of security are complementary.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@
<div className="accordion-item" data-level="1">

<h2 className="accordion-header" id="header107901251941">
<h2 className="accordion-header" id="header4846044344636">

<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-107901251941" aria-expanded="false" aria-controls="accordeon-107901251941">
107901251941, level 1
<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-4846044344636" aria-expanded="false" aria-controls="accordeon-4846044344636">
4846044344636, level 1

</button>
Expand All @@ -17,7 +17,7 @@
</h2>

<div id="accordeon-107901251941" className="accordion-collapse collapse">
<div id="accordeon-4846044344636" className="accordion-collapse collapse">

<div className="accordion-body">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@
<div className="accordion-item" data-level="1">

<h2 className="accordion-header" id="header4283595623103">
<h2 className="accordion-header" id="header6673556290625">

<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-4283595623103" aria-expanded="false" aria-controls="accordeon-4283595623103">
4283595623103, level 1
<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-6673556290625" aria-expanded="false" aria-controls="accordeon-6673556290625">
6673556290625, level 1

</button>
Expand All @@ -17,7 +17,7 @@
</h2>

<div id="accordeon-4283595623103" className="accordion-collapse collapse">
<div id="accordeon-6673556290625" className="accordion-collapse collapse">

<div className="accordion-body">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@
<div className="accordion-item" data-level="1">

<h2 className="accordion-header" id="header3047160101850">
<h2 className="accordion-header" id="header4535354117577">

<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-3047160101850" aria-expanded="false" aria-controls="accordeon-3047160101850">
3047160101850, level 1
<button className="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#accordeon-4535354117577" aria-expanded="false" aria-controls="accordeon-4535354117577">
4535354117577, level 1

</button>
Expand All @@ -17,7 +17,7 @@
</h2>

<div id="accordeon-3047160101850" className="accordion-collapse collapse">
<div id="accordeon-4535354117577" className="accordion-collapse collapse">

<div className="accordion-body">
Expand Down

Large diffs are not rendered by default.

Binary file not shown.

Large diffs are not rendered by default.

Binary file not shown.
21 changes: 7 additions & 14 deletions logs/brokenLinks.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,18 @@
# Broken Links Report

Created: 2024-01-08T03:13:47.900Z
Created: 2024-01-10T12:59:36.784Z

## Total Broken Links Found: 19
## Total Broken Links Found: 12

- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/concepts/.https://github.com/WebOfTrust/WOT-terms/blob/main/LICENSE](https://weboftrust.github.io/WOT-terms/docs/concepts/.https://github.com/WebOfTrust/WOT-terms/blob/main/LICENSE), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/concepts/concepts](https://weboftrust.github.io/WOT-terms/docs/concepts/concepts)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/concepts/trans-contextual-value](https://weboftrust.github.io/WOT-terms/docs/concepts/trans-contextual-value), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/concepts/concepts](https://weboftrust.github.io/WOT-terms/docs/concepts/concepts)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/validation](https://weboftrust.github.io/WOT-terms/docs/glossary/validation), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/concepts/concepts](https://weboftrust.github.io/WOT-terms/docs/concepts/concepts)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/kerisse.org](https://weboftrust.github.io/WOT-terms/docs/glossary/kerisse.org), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/Home](https://weboftrust.github.io/WOT-terms/docs/glossary/Home)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/encrypt%E2%80%90sender%E2%80%90sign%E2%80%90receiver](https://weboftrust.github.io/WOT-terms/docs/glossary/encrypt%E2%80%90sender%E2%80%90sign%E2%80%90receiver), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/ESSR](https://weboftrust.github.io/WOT-terms/docs/glossary/ESSR)
- Broken Link: [https://weboftrust.github.io/framework/docs/essifLab-principles](https://weboftrust.github.io/framework/docs/essifLab-principles), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossaries-external/glossary-essiflab](https://weboftrust.github.io/WOT-terms/docs/glossaries-external/glossary-essiflab)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/#key-rotation](https://weboftrust.github.io/WOT-terms/docs/glossary/#key-rotation), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/#safety-properties](https://weboftrust.github.io/WOT-terms/docs/glossary/#safety-properties), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/#keri-agreement-algorithm-for-control-establishment](https://weboftrust.github.io/WOT-terms/docs/glossary/#keri-agreement-algorithm-for-control-establishment), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/autonomic-identifier-(AID](https://weboftrust.github.io/WOT-terms/docs/glossary/autonomic-identifier-(AID), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/#Finger-pointing](https://weboftrust.github.io/WOT-terms/docs/glossary/#Finger-pointing), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/#Sources-Definition-ChatGPT](https://weboftrust.github.io/WOT-terms/docs/glossary/#Sources-Definition-ChatGPT), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/key-event-receipt-infratructure](https://weboftrust.github.io/WOT-terms/docs/glossary/key-event-receipt-infratructure), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/keridemlia](https://weboftrust.github.io/WOT-terms/docs/glossary/keridemlia)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/Interactive-authentication-design](https://weboftrust.github.io/WOT-terms/docs/glossary/Interactive-authentication-design), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/non-interactive-authentication-design](https://weboftrust.github.io/WOT-terms/docs/glossary/non-interactive-authentication-design)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/autonomic-identifier-(AID](https://weboftrust.github.io/WOT-terms/docs/glossary/autonomic-identifier-(AID), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/party](https://weboftrust.github.io/WOT-terms/docs/glossary/party), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/verify](https://weboftrust.github.io/WOT-terms/docs/glossary/verify)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/mutli-factor-authentication](https://weboftrust.github.io/WOT-terms/docs/glossary/mutli-factor-authentication), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossary/threshold-structure-security](https://weboftrust.github.io/WOT-terms/docs/glossary/threshold-structure-security)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/04_glossary/index.md](https://weboftrust.github.io/WOT-terms/docs/04_glossary/index.md), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/education/q-and-a-security](https://weboftrust.github.io/WOT-terms/docs/education/q-and-a-security), [https://weboftrust.github.io/WOT-terms/docs/education/q-and-a](https://weboftrust.github.io/WOT-terms/docs/education/q-and-a)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary](https://weboftrust.github.io/WOT-terms/docs/glossary), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE](https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE)
- Broken Link: [https://weboftrust.github.io/framework/docs/essifLab-principles](https://weboftrust.github.io/framework/docs/essifLab-principles), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/glossary-unified), [https://weboftrust.github.io/WOT-terms/docs/glossaries-external/glossary-essiflab](https://weboftrust.github.io/WOT-terms/docs/glossaries-external/glossary-essiflab)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/04_glossary/index.md](https://weboftrust.github.io/WOT-terms/docs/04_glossary/index.md), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/education/q-and-a-security](https://weboftrust.github.io/WOT-terms/docs/education/q-and-a-security)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary/AN](https://weboftrust.github.io/WOT-terms/docs/glossary/AN), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE](https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/test/glossary-unified](https://weboftrust.github.io/WOT-terms/docs/test/glossary-unified), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE](https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE)
- Broken Link: [https://weboftrust.github.io/WOT-terms/docs/glossary](https://weboftrust.github.io/WOT-terms/docs/glossary), Found on Pages: [https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE](https://weboftrust.github.io/WOT-terms/docs/overview/indexed-in-KERISSE)
Loading

0 comments on commit 3476b10

Please sign in to comment.