diff --git a/spec/Protocol_Interface_PeerSecurity.xml b/spec/Protocol_Interface_PeerSecurity.xml new file mode 100644 index 0000000..607b6e5 --- /dev/null +++ b/spec/Protocol_Interface_PeerSecurity.xml @@ -0,0 +1,92 @@ + + + + Copyright © 2011 Collabora Ltd. + +

This library 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.

+ +

This library 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 library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + 02110-1301, USA.

+
+ + + (as stable API) + + + +

An interface to examine the security properties of a peers or servers + that can be connected to via this protocol.

+
+ + + +

Make a request to retrieve the TLS certificates that can be used to + authenticate a peer an establish security.

+
+ + + + A set of parameters as would be provided to RequestConnection. Only parameters relevant to + connecting to a peer will be use to perform this operation. + + + + + +

An opaque string which identifies this retrieve request. + The same string will be used in the + RetrievedCertificates signal.

+
+
+
+ + + + + The opaque string returned from + RetrieveCertificates. + + + + + The type of the certificate. Either 'x509', 'pgp' or '' when no + certificates were found. + + + + + The certificates retrieved. When CertificateType is 'x509' this + represents a certificate chain the first of which is the peer's own + certificate. If an empty array, then no certificates were retrieved. + + + + Emitted when the results of a + RetrieveCertificates are ready. + + + +
+
diff --git a/spec/all.xml b/spec/all.xml index 63353c5..26df8cf 100644 --- a/spec/all.xml +++ b/spec/all.xml @@ -36,6 +36,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. +