activitystreams 0.6.2

Activity Streams in Rust
Documentation 
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

/*
 * This file is part of ActivityStreams.
 *
 * Copyright © 2020 Riley Trautman
 *
 * ActivityStreams is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * ActivityStreams 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with ActivityStreams.  If not, see <http://www.gnu.org/licenses/>.
 */

//! Endpoint traits and types

use crate::{primitives::XsdAnyUri, properties};

properties! {
    Endpoint {
        docs [
            "A json object which maps additional (typically server/domain-wide) endpoints which may be",
            "useful either for this actor or someone referencing this actor.",
            "",
            "This mapping may be nested inside the actor document as the value or may be a link to a JSON-LD",
            "document with these properties.",
        ],

        proxy_url {
            docs [
                "Endpoint URI so this actor's clients may access remote ActivityStreams objects which",
                "require authentication to access.",
                "",
                "To use this endpoint, the client posts an x-www-form-urlencoded id parameter with the value",
                "being the id of the requested ActivityStreams object.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },

        oauth_authorization_endpoint {
            docs [
                "If OAuth 2.0 bearer tokens [[RFC6749](https://tools.ietf.org/html/rfc6749)]",
                "[[RFC6750](https://tools.ietf.org/html/rfc6750)] are being used for authenticating client",
                "to server interactions, this endpoint specifies a URI at which a browser-authenticated user",
                "may obtain a new authorization grant.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },

        oauth_token_endpoint {
            docs [
                "If OAuth 2.0 bearer tokens [[RFC6749](https://tools.ietf.org/html/rfc6749)]",
                "[[RFC6750](https://tools.ietf.org/html/rfc6750)] are being used for authenticating client",
                "to server interactions, this endpoint specifies a URI at which a client may acquire an",
                "access token.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },

        provide_client_key {
            docs [
                "If Linked Data Signatures and HTTP Signatures are being used for authentication and",
                "authorization, this endpoint specifies a URI at which browser-authenticated users may",
                "authorize a client's public key for client to server interactions.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },

        sign_client_key {
            docs [
                "If Linked Data Signatures and HTTP Signatures are being used for authentication and",
                "authorization, this endpoint specifies a URI at which a client key may be signed by the",
                "actor's key for a time window to act on behalf of the actor in interacting with foreign",
                "servers.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },

        shared_inbox {
            docs [
                "An optional endpoint used for wide delivery of publicly addressed activities and activities",
                "sent to followers.",
                "",
                "`shared_inbox`endpoints SHOULD also be publicly readable `OrderedCollection` objects",
                "containing objects addressed to the Public special collection. Reading from the",
                "`shared_inbox` endpoint MUST NOT present objects which are not addressed to the Public",
                "endpoint.",
                "",
                "- Range: `anyUri`",
                "- Functional: true",
            ],
            types [ XsdAnyUri ],
            functional,
        },
    }
}