aboutsummaryrefslogtreecommitdiffstats
path: root/lang/js/src/permittedOperations.js
blob: 79e742230c2181c8db0aae91ad07718a717a453d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
/* gpgme.js - Javascript integration for gpgme
 * Copyright (C) 2018 Bundesamt für Sicherheit in der Informationstechnik
 *
 * This file is part of GPGME.
 *
 * GPGME is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * GPGME is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this program; if not, see <http://www.gnu.org/licenses/>.
 * SPDX-License-Identifier: LGPL-2.1+
 */

 /**
  * Definition of the possible interactions with gpgme-json.
  * operation: <Object>
      required: Array<String>
      optional: Array<String>
      pinentry: Boolean If a pinentry dialog is expected, and a timeout of
                5000 ms would be too short
      answer: <Object>
          type: <String< The content type of answer expected
          data: Array<String> The payload property of the answer. May be
                partial and in need of concatenation
          params: Array<String> Information that do not change throughout
                the message
          infos: Array<*> arbitrary information that may result in a list
      }
  }
  */

export const permittedOperations = {
    encrypt: {
        required: ['keys', 'data'],
        optional: [
            'protocol',
            'chunksize',
            'base64',
            'mime',
            'armor',
            'always-trust',
            'no-encrypt-to',
            'no-compress',
            'throw-keyids',
            'want-address',
            'wrap'
        ],
        answer: {
            type: ['ciphertext'],
            data: ['data'],
            params: ['base64'],
            infos: []
        }
    },

    decrypt: {
        pinentry: true,
        required: ['data'],
        optional: [
            'protocol',
            'chunksize',
            'base64'
        ],
        answer: {
            type: ['plaintext'],
            data: ['data'],
            params: ['base64', 'mime'],
            infos: [] // pending. Info about signatures and validity
                    //signature: [{Key Fingerprint, valid Boolean}]
        }
    },
    /**
    keyinfo: { // querying the Key's information.
        required: ['fingerprint'],
        anser: {
            type: ['TBD'],
            data: [],
            params: ['hasSecret', 'isRevoked', 'isExpired', 'armored',
                'timestamp', 'expires', 'pubkey_algo'],
            infos: ['subkeys', 'userIds']
    }*/

    /**
    listkeys:{
        optional: ['with-secret', 'pattern'],
    answer: {
        type: ['TBD'], //Array of fingerprints?
        infos: ['TBD'] //the property with infos
    },
    */

    /**
    importkey: {
        required: ['keyarmored'],
        answer: {
            type: ['TBD'],
            infos: [''], // for each key if import was a success, if it was an update
        }
    },
    */

    /**
    deletekey:  {
        required: ['fingerprint'],
        answer: {
            type ['TBD'],
            infos: [''] //success:true? in gpgme, an error NO_ERROR is returned
        }
    }
    */

    /**
     *get armored secret different treatment from keyinfo!
     */

    /**
     * TBD key modification requests?
     */
}