Buckets:

download
raw
5.54 kB
{
"name": "Password-based authentication",
"summary": "A subject proves they own a claimed identity by providing a correct identifier, such as a username or email address, and the corresponding password. This pattern relies on the assumption that only the actual owner of the claimed identity knows the correct password.",
"roles": [
{
"name": "Subject",
"type": "Entity",
"required": false,
"description": "wants to login into the `System`"
},
{
"name": "Enforcer",
"type": "Enforcement point",
"required": true,
"description": "ensures the requested action is only performed if the `Subject` is successfully authenticated, this entity must be incorporated into the `System`"
},
{
"name": "Verification manager",
"type": "Entity",
"required": true,
"description": "is responsible to collect the inputs necessary to verify a `Subject`'s password"
},
{
"name": "Password store",
"type": "Storage",
"required": true,
"description": "keeps track of the hash values corresponding to each registered identity"
},
{
"name": "Hasher",
"type": "Cryptographic primitive",
"required": true,
"description": "calculates the hash value for a given input"
},
{
"name": "Pepper store",
"type": "Storage",
"required": true,
"description": "keeps track of the pepper value(s) used by the system"
},
{
"name": "Encrypter",
"type": "Cryptographic primitive",
"required": true,
"description": "encrypts a given data element using a given cryptographic key"
},
{
"name": "Comparator",
"type": "Decision point",
"required": true,
"description": "compares the hash value of the received password against that provided by the `Password store`"
},
{
"name": "System",
"type": "Entity",
"required": false,
"description": "contains the business logic corresponding to the requested action"
}
],
"behaviour": [
{
"step": "1",
"from": "Subject",
"to": "Enforcer",
"kind": "action",
"element": "action(id, pwd[, args])",
"description": "The `Subject` provides the `Enforcer` with its identifier and password as part of its action request. Otherwise the `Subject` is informed of the failure to login."
},
{
"step": "2",
"from": "Enforcer",
"to": "Verification manager",
"kind": "action",
"element": "verify(id, pwd)",
"description": "The `Enforcer` forwards the identifier and password to the `Verification manager` for verification and blocks the login request awaiting an answer. The `Verification manager` forwards the result of the password verification to the `Enforcer`."
},
{
"step": "3",
"from": "Verification manager",
"to": "Password store",
"kind": "action",
"element": "get_pwd(id)",
"description": "The `Verification manager` requests the stored hash value and salt from the `Password store`. The `Verification manager` receives the requested hash value and salt from the `Password store`."
},
{
"step": "4",
"from": "Verification manager",
"to": "Hasher",
"kind": "action",
"element": "calculate_hash(salt, pwd)",
"description": "The `Verification manager` forwards the received salt and password to the `Hasher`. The `Hasher` calculates the requested hash value and transmits the result back to the `Verification manager`."
},
{
"step": "5",
"from": "Verification manager",
"to": "Pepper store",
"kind": "action",
"element": "get_pepper(id)",
"description": "The `Verification manager` requests the correct pepper value from the `Pepper store`. The `Pepper store` replies with the corresponding pepper value."
},
{
"step": "6",
"from": "Verification manager",
"to": "Encrypter",
"kind": "action",
"element": "encrypt(pepper, hash(salt, pwd))",
"description": "The `Verification manager` forwards the received pepper along with the password's hash value to the `Encrypter`. The `Encrypter` encrypts the received hash value using the pepper as cryptographic key and replies the resulting ciphertext to the `Verification manager`."
},
{
"step": "7",
"from": "Verification manager",
"to": "Comparator",
"kind": "action",
"element": "compare(stored_pwd, {hash(salt, pwd)}_pepper)",
"description": "The `Verification manager` forwards the received ciphertext and the stored hash value to the `Comparator` for comparison. The `Comparator` checks whether the newly calculated ciphertext is identical to the one that was retrieved from the `Password store` and informs the `Verification manager` of the result of the verification."
},
{
"step": "8",
"from": "Enforcer",
"to": "System",
"kind": "action",
"element": "action(id[, args])",
"description": "If the `Enforcer` receives confirmation that the provided password is correct, the `Enforcer` forwards the login action request to the `System`."
},
{
"step": "9",
"from": "System",
"to": "Subject",
"kind": "data",
"element": "reply",
"description": "Optionally, the `System` replies to the `Subject` after receiving and/or executing the action request. This reply does not need to pass through the `Enforcer`."
}
]
}

Xet Storage Details

Size:
5.54 kB
·
Xet hash:
1c682e791c57201cc0ecdcced40e6b0a84d5d326183b0cbe1ae8c8e32326f39b

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.