summaryrefslogtreecommitdiffstats
path: root/dom/media/webrtc/PeerIdentity.h
blob: 64364d3359a5a0bbe1721423c6ce8e78e5079b69 (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
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * vim: sw=2 ts=2 sts=2 expandtab
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef PeerIdentity_h
#define PeerIdentity_h

#include "nsISupportsImpl.h"
#include "nsString.h"

template <class T>
class nsCOMPtr;
class nsIIDNService;

namespace mozilla {

/**
 * This class implements the identifier used in WebRTC identity.  Peers are
 * identified using a string in the form [<user>@]<domain>, for instance,
 * "user@example.com'. The (optional) user portion is a site-controlled string
 * containing any character other than '@'.  The domain portion is a valid IDN
 * domain name and is compared accordingly.
 *
 * See:
 * http://tools.ietf.org/html/draft-ietf-rtcweb-security-arch-09#section-5.6.5.3.3.1
 */
class PeerIdentity final {
 public:
  NS_INLINE_DECL_REFCOUNTING(PeerIdentity)

  explicit PeerIdentity(const nsAString& aPeerIdentity)
      : mPeerIdentity(aPeerIdentity) {}

  bool Equals(const PeerIdentity& aOther) const;
  bool Equals(const nsAString& aOtherString) const;
  const nsString& ToString() const { return mPeerIdentity; }

 private:
  ~PeerIdentity() = default;
  static void GetUser(const nsAString& aPeerIdentity, nsAString& aUser);
  static void GetHost(const nsAString& aPeerIdentity, nsAString& aHost);

  static void GetNormalizedHost(const nsCOMPtr<nsIIDNService>& aIdnService,
                                const nsAString& aHost,
                                nsACString& aNormalizedHost);

  nsString mPeerIdentity;
};

inline bool operator==(const PeerIdentity& aOne, const PeerIdentity& aTwo) {
  return aOne.Equals(aTwo);
}

inline bool operator==(const PeerIdentity& aOne, const nsAString& aString) {
  return aOne.Equals(aString);
}

inline bool operator!=(const PeerIdentity& aOne, const PeerIdentity& aTwo) {
  return !aOne.Equals(aTwo);
}

inline bool operator!=(const PeerIdentity& aOne, const nsAString& aString) {
  return !aOne.Equals(aString);
}

} /* namespace mozilla */

#endif /* PeerIdentity_h */