gnunet-svn
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[taler-anastasis] branch master updated: do not repeat title slide


From: gnunet
Subject: [taler-anastasis] branch master updated: do not repeat title slide
Date: Wed, 10 Jun 2020 23:58:53 +0200

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository anastasis.

The following commit(s) were added to refs/heads/master by this push:
     new 4f95749  do not repeat title slide
4f95749 is described below

commit 4f95749b004dc1a770bcfa5a57d41e6deb5aee13
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Wed Jun 10 23:58:51 2020 +0200

    do not repeat title slide
---
 doc/thesis/rest_api_documentation.tex | 44 +++++++++++++++++------------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/doc/thesis/rest_api_documentation.tex 
b/doc/thesis/rest_api_documentation.tex
index 6b96c71..a2218b9 100644
--- a/doc/thesis/rest_api_documentation.tex
+++ b/doc/thesis/rest_api_documentation.tex
@@ -1,9 +1,9 @@
-\title{Anastasis REST API}
-\date{\today}   %% or \date{01 november 2018}
-\author{Dominik Meister (\texttt{dominiksamuel.meister@students.bfh.ch}) \\
-  Dennis Neufeld (\texttt{dennis.neufeld@students.bfh.ch })}
-\maketitle
-\clearpage
+%\title{Anastasis REST API}
+%\date{\today}   %% or \date{01 november 2018}
+%\author{Dominik Meister (\texttt{dominiksamuel.meister@students.bfh.ch}) \\
+%  Dennis Neufeld (\texttt{dennis.neufeld@students.bfh.ch })}
+%\maketitle
+%\clearpage
 
 \section{REST API documentation} \label{appendix_server_api}
 The server api is a RESTful API which has the following endpoints.
@@ -12,12 +12,12 @@ The server api is a RESTful API which has the following 
endpoints.
 \textbf{GET /salt}
 \\
 Obtain the salt used by the escrow provider. Different providers will use 
different high-entropy salt values. The resulting provider salt is then used in 
various operations to ensure cryptographic operations differ by provider. A 
provider must never change its salt value. \\
-\textbf{Response: } \\  
+\textbf{Response: } \\
 Returns a "SaltResponse".
 \begin{lstlisting}
-interface SaltResponse { 
-  // salt value, at least 128 bits of entropy 
-  server_salt: string; 
+interface SaltResponse {
+  // salt value, at least 128 bits of entropy
+  server_salt: string;
 }
 \end{lstlisting}
 
@@ -27,10 +27,10 @@ interface SaltResponse {
 Obtain the terms of service provided by the escrow provider.
 \\
 \textbf{Response: } \\
-Returns an EscrowTermsOfServiceResponse. \\ 
+Returns an EscrowTermsOfServiceResponse. \\
 
 \begin{lstlisting}
-interface EscrowTermsOfServiceResponse { 
+interface EscrowTermsOfServiceResponse {
 
   // minimum supported protocol version
   min_version: number;
@@ -48,9 +48,9 @@ interface EscrowTermsOfServiceResponse {
   monthly_account_fee: Amount;
 
   // Amount required per policy upload. Note that the amount is NOT
-  // charged additionally to the monthly_storage_fee. Instead, 
+  // charged additionally to the monthly_storage_fee. Instead,
   // when a payment is made, the amount is divided by the policy_upload_fee
-  // (and rounded down) to determine how many uploads can be made 
+  // (and rounded down) to determine how many uploads can be made
   // under the associated payment identifier.
   policy_upload_ratio: Amount;
 
@@ -98,7 +98,7 @@ In the following, UUID is always defined and used according 
to RFC 4122. \\
 \\
 \textbf{GET /policy/\$ACCOUNT\_PUB[?version=\$NUMBER]} \\
 \\
-Get the customer’s encrypted recovery document. If “version” is not specified, 
the server returns the latest available version. If “version” is specified, 
returns the policy with the respective “version”. The response must begin with 
the nonce and an AES-GCM tag and continue with the ciphertext. Once decrypted, 
the plaintext is expected to contain: 
+Get the customer’s encrypted recovery document. If “version” is not specified, 
the server returns the latest available version. If “version” is specified, 
returns the policy with the respective “version”. The response must begin with 
the nonce and an AES-GCM tag and continue with the ciphertext. Once decrypted, 
the plaintext is expected to contain:
 \begin{itemize}
 \item the escrow policy
 \item the separately encrypted master public key
@@ -144,7 +144,7 @@ Anastasis-Policy-Signature: The client must provide Base-32 
encoded EdDSA signat
 \textit{Payment-Identifier:} Base-32 encoded 32-byte payment identifier that 
was included in a previous payment (see 402 status code). Used to allow the 
server to check that the client paid for the upload (to protect the server 
against DoS attacks) and that the client knows a real secret of financial value 
(as the kdf\_id might be known to an attacker). If this header is missing in 
the client’s request (or the associated payment has exceeded the upload limit), 
the server must return a 40 [...]
  \\
 \begin{lstlisting}
-interface EncryptedRecoveryDocument { 
+interface EncryptedRecoveryDocument {
   // Nonce used to compute the (iv,key) pair for encryption
   // of the encrypted_compressed_recovery_document.
   nonce: [32]; //bytearray
@@ -157,7 +157,7 @@ interface EncryptedRecoveryDocument {
   // The nonce of the HKDF for this encryption must include the
   // string "ERD".
   // bytearray of undefined length
-  encrypted_compressed_recovery_document: []; 
+  encrypted_compressed_recovery_document: [];
 
 }
 \end{lstlisting}
@@ -182,7 +182,7 @@ interface RecoveryDocument {
 
 \begin{lstlisting}
 interface EscrowMethod {
-  // URL of the escrow provider 
+  // URL of the escrow provider
   // (including possibly this Anastasis server)
   provider_url : string;
 
@@ -249,11 +249,11 @@ Upload a TruthUploadRequest-Object according to the 
policy the client created be
 \item 409 Conflict – The server already has some truth stored under this UUID. 
The client should check that it is generating UUIDs with enough entropy.
 \item 412 Precondition Failed – The selected authentication method is not 
supported on this provider.
 \end{itemize}
-\textbf{Details:} 
+\textbf{Details:}
 \begin{lstlisting}
 interface TruthUploadRequest {
   // Contains the information of an interface EncryptedKeyShare,
-  // but simply as one binary block (in Crockford Base32 
+  // but simply as one binary block (in Crockford Base32
   // encoding for JSON).
   key_share_data: []; //bytearray
 
@@ -321,11 +321,11 @@ interface EncryptedKeyShare {
 \end{lstlisting}
 \begin{lstlisting}
 interface KeyShare {
-  // Key material to concatenate with policy_salt 
+  // Key material to concatenate with policy_salt
   // and KDF to derive the key to decrypt the master key.
   key_share: [32]; //bytearray
 
   // Signature over method, uuid, and key_share.
   account_sig: EddsaSignature;
 }
-\end{lstlisting}
\ No newline at end of file
+\end{lstlisting}

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]