RLMSyncConfiguration.mm 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323
  1. ////////////////////////////////////////////////////////////////////////////
  2. //
  3. // Copyright 2016 Realm Inc.
  4. //
  5. // Licensed under the Apache License, Version 2.0 (the "License");
  6. // you may not use this file except in compliance with the License.
  7. // You may obtain a copy of the License at
  8. //
  9. // http://www.apache.org/licenses/LICENSE-2.0
  10. //
  11. // Unless required by applicable law or agreed to in writing, software
  12. // distributed under the License is distributed on an "AS IS" BASIS,
  13. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. // See the License for the specific language governing permissions and
  15. // limitations under the License.
  16. //
  17. ////////////////////////////////////////////////////////////////////////////
  18. #import "RLMSyncConfiguration_Private.hpp"
  19. #import "RLMRealmConfiguration+Sync.h"
  20. #import "RLMSyncManager_Private.h"
  21. #import "RLMSyncSession_Private.hpp"
  22. #import "RLMSyncSessionRefreshHandle.hpp"
  23. #import "RLMSyncUser_Private.hpp"
  24. #import "RLMSyncUtil_Private.hpp"
  25. #import "RLMUtil.hpp"
  26. #import "sync/sync_manager.hpp"
  27. #import "sync/sync_config.hpp"
  28. #import <realm/sync/protocol.hpp>
  29. using namespace realm;
  30. namespace {
  31. using ProtocolError = realm::sync::ProtocolError;
  32. RLMSyncSystemErrorKind errorKindForSyncError(SyncError error) {
  33. if (error.is_client_reset_requested()) {
  34. return RLMSyncSystemErrorKindClientReset;
  35. } else if (error.error_code == ProtocolError::permission_denied) {
  36. return RLMSyncSystemErrorKindPermissionDenied;
  37. } else if (error.error_code == ProtocolError::bad_authentication) {
  38. return RLMSyncSystemErrorKindUser;
  39. } else if (error.is_session_level_protocol_error()) {
  40. return RLMSyncSystemErrorKindSession;
  41. } else if (error.is_connection_level_protocol_error()) {
  42. return RLMSyncSystemErrorKindConnection;
  43. } else if (error.is_client_error()) {
  44. return RLMSyncSystemErrorKindClient;
  45. } else {
  46. return RLMSyncSystemErrorKindUnknown;
  47. }
  48. }
  49. BOOL isValidRealmURL(NSURL *url) {
  50. NSString *scheme = [url scheme];
  51. return [scheme isEqualToString:@"realm"] || [scheme isEqualToString:@"realms"];
  52. }
  53. }
  54. @interface RLMSyncConfiguration () {
  55. std::unique_ptr<realm::SyncConfig> _config;
  56. }
  57. - (instancetype)initWithUser:(RLMSyncUser *)user
  58. realmURL:(NSURL *)url
  59. customFileURL:(nullable NSURL *)customFileURL
  60. isPartial:(BOOL)isPartial
  61. stopPolicy:(RLMSyncStopPolicy)stopPolicy;
  62. @end
  63. @implementation RLMSyncConfiguration
  64. @dynamic stopPolicy;
  65. - (instancetype)initWithRawConfig:(realm::SyncConfig)config {
  66. if (self = [super init]) {
  67. _config = std::make_unique<realm::SyncConfig>(std::move(config));
  68. }
  69. return self;
  70. }
  71. - (BOOL)isEqual:(id)object {
  72. if (![object isKindOfClass:[RLMSyncConfiguration class]]) {
  73. return NO;
  74. }
  75. RLMSyncConfiguration *that = (RLMSyncConfiguration *)object;
  76. return [self.realmURL isEqual:that.realmURL]
  77. && [self.user isEqual:that.user]
  78. && self.stopPolicy == that.stopPolicy
  79. && self.fullSynchronization == that.fullSynchronization;
  80. }
  81. - (void)setEnableSSLValidation:(BOOL)enableSSLValidation {
  82. _config->client_validate_ssl = (bool)enableSSLValidation;
  83. }
  84. - (BOOL)enableSSLValidation {
  85. return (BOOL)_config->client_validate_ssl;
  86. }
  87. - (void)setIsPartial:(BOOL)isPartial {
  88. _config->is_partial = (bool)isPartial;
  89. }
  90. - (BOOL)isPartial {
  91. return (BOOL)_config->is_partial;
  92. }
  93. - (NSURL *)pinnedCertificateURL {
  94. if (auto& path = _config->ssl_trust_certificate_path) {
  95. return [NSURL fileURLWithPath:RLMStringDataToNSString(*path)];
  96. }
  97. return nil;
  98. }
  99. - (void)setPinnedCertificateURL:(NSURL *)pinnedCertificateURL {
  100. if (pinnedCertificateURL) {
  101. if ([pinnedCertificateURL respondsToSelector:@selector(UTF8String)]) {
  102. _config->ssl_trust_certificate_path = std::string([(id)pinnedCertificateURL UTF8String]);
  103. }
  104. else {
  105. _config->ssl_trust_certificate_path = std::string(pinnedCertificateURL.path.UTF8String);
  106. }
  107. }
  108. else {
  109. _config->ssl_trust_certificate_path = util::none;
  110. }
  111. }
  112. - (void)setFullSynchronization:(BOOL)fullSynchronization {
  113. _config->is_partial = !(bool)fullSynchronization;
  114. }
  115. - (BOOL)fullSynchronization {
  116. return !(BOOL)_config->is_partial;
  117. }
  118. - (realm::SyncConfig&)rawConfiguration {
  119. return *_config;
  120. }
  121. - (RLMSyncUser *)user {
  122. return [[RLMSyncUser alloc] initWithSyncUser:_config->user];
  123. }
  124. - (RLMSyncStopPolicy)stopPolicy {
  125. return translateStopPolicy(_config->stop_policy);
  126. }
  127. - (void)setStopPolicy:(RLMSyncStopPolicy)stopPolicy {
  128. _config->stop_policy = translateStopPolicy(stopPolicy);
  129. }
  130. - (NSString *)urlPrefix {
  131. if (_config->url_prefix) {
  132. return @(_config->url_prefix->c_str());
  133. }
  134. return nil;
  135. }
  136. - (void)setUrlPrefix:(NSString *)urlPrefix {
  137. if (urlPrefix) {
  138. _config->url_prefix.emplace(urlPrefix.UTF8String);
  139. } else {
  140. _config->url_prefix = none;
  141. }
  142. }
  143. - (bool)cancelAsyncOpenOnNonFatalErrors {
  144. return _config->cancel_waits_on_nonfatal_error;
  145. }
  146. - (void)setCancelAsyncOpenOnNonFatalErrors:(bool)cancelAsyncOpenOnNonFatalErrors {
  147. _config->cancel_waits_on_nonfatal_error = cancelAsyncOpenOnNonFatalErrors;
  148. }
  149. - (NSURL *)realmURL {
  150. NSString *rawStringURL = @(_config->reference_realm_url.c_str());
  151. return [NSURL URLWithString:rawStringURL];
  152. }
  153. - (instancetype)initWithUser:(RLMSyncUser *)user realmURL:(NSURL *)url {
  154. return [self initWithUser:user
  155. realmURL:url
  156. customFileURL:nil
  157. isPartial:NO
  158. stopPolicy:RLMSyncStopPolicyAfterChangesUploaded];
  159. }
  160. - (instancetype)initWithUser:(RLMSyncUser *)user
  161. realmURL:(NSURL *)url
  162. isPartial:(BOOL)isPartial
  163. urlPrefix:(NSString *)urlPrefix
  164. stopPolicy:(RLMSyncStopPolicy)stopPolicy
  165. enableSSLValidation:(BOOL)enableSSLValidation
  166. certificatePath:(nullable NSURL *)certificatePath {
  167. auto config = [self initWithUser:user
  168. realmURL:url
  169. customFileURL:nil
  170. isPartial:isPartial
  171. stopPolicy:stopPolicy];
  172. config.urlPrefix = urlPrefix;
  173. config.enableSSLValidation = enableSSLValidation;
  174. config.pinnedCertificateURL = certificatePath;
  175. return config;
  176. }
  177. static void bindHandler(std::string const&, SyncConfig const& config, std::shared_ptr<SyncSession> session) {
  178. const std::shared_ptr<SyncUser>& user = config.user;
  179. NSURL *realmURL = [NSURL URLWithString:@(config.realm_url().c_str())];
  180. NSString *path = [realmURL path];
  181. REALM_ASSERT(realmURL && path);
  182. auto handle = [[RLMSyncSessionRefreshHandle alloc] initWithRealmURL:realmURL
  183. user:user
  184. session:std::move(session)
  185. completionBlock:RLMSyncManager.sharedManager.sessionCompletionNotifier];
  186. context_for(user).register_refresh_handle([path UTF8String], handle);
  187. }
  188. static void errorHandler(std::shared_ptr<SyncSession> errored_session, SyncError error) {
  189. NSString *recoveryPath;
  190. RLMSyncErrorActionToken *token;
  191. for (auto& pair : error.user_info) {
  192. if (pair.first == realm::SyncError::c_original_file_path_key) {
  193. token = [[RLMSyncErrorActionToken alloc] initWithOriginalPath:pair.second];
  194. }
  195. else if (pair.first == realm::SyncError::c_recovery_file_path_key) {
  196. recoveryPath = @(pair.second.c_str());
  197. }
  198. }
  199. BOOL shouldMakeError = YES;
  200. NSDictionary *custom = nil;
  201. // Note that certain types of errors are 'interactive'; users have several options
  202. // as to how to proceed after the error is reported.
  203. auto errorClass = errorKindForSyncError(error);
  204. switch (errorClass) {
  205. case RLMSyncSystemErrorKindClientReset: {
  206. custom = @{kRLMSyncPathOfRealmBackupCopyKey: recoveryPath, kRLMSyncErrorActionTokenKey: token};
  207. break;
  208. }
  209. case RLMSyncSystemErrorKindPermissionDenied: {
  210. custom = @{kRLMSyncErrorActionTokenKey: token};
  211. break;
  212. }
  213. case RLMSyncSystemErrorKindUser:
  214. case RLMSyncSystemErrorKindSession:
  215. break;
  216. case RLMSyncSystemErrorKindConnection:
  217. case RLMSyncSystemErrorKindClient:
  218. case RLMSyncSystemErrorKindUnknown:
  219. // Report the error. There's nothing the user can do about it, though.
  220. shouldMakeError = error.is_fatal;
  221. break;
  222. }
  223. auto errorHandler = RLMSyncManager.sharedManager.errorHandler;
  224. if (!shouldMakeError || !errorHandler) {
  225. return;
  226. }
  227. NSError *nsError = make_sync_error(errorClass, @(error.message.c_str()), error.error_code.value(), custom);
  228. RLMSyncSession *session = [[RLMSyncSession alloc] initWithSyncSession:errored_session];
  229. dispatch_async(dispatch_get_main_queue(), ^{
  230. errorHandler(nsError, session);
  231. });
  232. };
  233. - (instancetype)initWithUser:(RLMSyncUser *)user
  234. realmURL:(NSURL *)url
  235. customFileURL:(nullable NSURL *)customFileURL
  236. isPartial:(BOOL)isPartial
  237. stopPolicy:(RLMSyncStopPolicy)stopPolicy {
  238. if (self = [super init]) {
  239. if (!isValidRealmURL(url)) {
  240. @throw RLMException(@"The provided URL (%@) was not a valid Realm URL.", [url absoluteString]);
  241. }
  242. _config = std::make_unique<SyncConfig>(SyncConfig{
  243. [user _syncUser],
  244. [[url absoluteString] UTF8String]
  245. });
  246. _config->stop_policy = translateStopPolicy(stopPolicy);
  247. _config->bind_session_handler = bindHandler;
  248. _config->error_handler = errorHandler;
  249. _config->is_partial = isPartial;
  250. _config->client_resync_mode = realm::ClientResyncMode::Manual;
  251. if (NSString *authorizationHeaderName = [RLMSyncManager sharedManager].authorizationHeaderName) {
  252. _config->authorization_header_name.emplace(authorizationHeaderName.UTF8String);
  253. }
  254. if (NSDictionary<NSString *, NSString *> *customRequestHeaders = [RLMSyncManager sharedManager].customRequestHeaders) {
  255. for (NSString *key in customRequestHeaders) {
  256. _config->custom_http_headers.emplace(key.UTF8String, customRequestHeaders[key].UTF8String);
  257. }
  258. }
  259. self.customFileURL = customFileURL;
  260. return self;
  261. }
  262. return nil;
  263. }
  264. + (RLMRealmConfiguration *)automaticConfiguration {
  265. if (RLMSyncUser.allUsers.count != 1)
  266. @throw RLMException(@"The automatic configuration requires there be exactly one logged-in sync user.");
  267. return [RLMSyncConfiguration automaticConfigurationForUser:RLMSyncUser.currentUser];
  268. }
  269. + (RLMRealmConfiguration *)automaticConfigurationForUser:(RLMSyncUser *)user {
  270. RLMSyncConfiguration *syncConfig = [[RLMSyncConfiguration alloc] initWithUser:user
  271. realmURL:user.defaultRealmURL
  272. customFileURL:nil
  273. isPartial:YES
  274. stopPolicy:RLMSyncStopPolicyAfterChangesUploaded];
  275. RLMRealmConfiguration *config = [[RLMRealmConfiguration alloc] init];
  276. config.syncConfiguration = syncConfig;
  277. return config;
  278. }
  279. @end