[GROOMING] Contact synchonization v2

[hoangdat]

Desc:

• ADR: https://www.notion.so/linagora/ADR-Contact-Sync-in-TWP-34b87eca754d4614ad9d9a050a1cd956

DoD:

• Synchronize contact to web app

[hoangdat]

• hashDetails: n peppers

{
  "algorithms": [
    "none",
    "sha256"
  ],
  "lookup_pepper": "matrixrocks",
  "alt_lookup_peppers": ["oldmatrixrocks"]
}

• 1 pid <-> n hash: Map<String, List<String>: map between pid to each hash of this

[hoangdat]

class ThirdPartyLookupAPI {
  Future<Response> lookup(baseUrl, accessToken, List<CalculatedHash>) {
    // create + setup dio
    // get response from thirdparty 
  }
}

[hoangdat]

https://www.notion.so/linagora/ADR-Contact-Synching-34b87eca754d4614ad9d9a050a1cd956?d=14562718bad1806c814b001c8e0ab4b8#13f62718bad1805d93bdfc0eab90d78e

[hoangdat]

1. How to extract Fed server in well-known?
2. How Contact Manager work in case Fed available, or not?
3. How to work with Fed server?

• how to get token for Fed server?
• how to handle this token when it is expired?

4. How to get /hash_details in Fed?
5. How to fetch /look_up in Fed?
6. How to handle mappings in /look_up response?
7. How to handle third_party_mappings in /look_up response?

[nqhhdev]

How to extract Fed server in well-know

• ENDPOINT {{homeserver}}.well-known/matrix/client

• Response

{
    ...
    "m.federated_identity_services": {
        "base_urls": [
            "https://fed...com/"
        ]
    },
    ...
}

Create Fed server info:

@JsonSerializable()
class FedServerInformation with EquatableMixin {
  static const String fedServerKey = 'm.federated_identity_services';

  @JsonKey(name: 'base_url')
  final Uri? baseUrl;

  @JsonKey(name: 'server_name')
  final String? serverName;

  FedServerInformation({
    this.baseUrl,
    this.serverName,
  });

  factory FedServerInformation.fromJson(Map<String, dynamic> json) =>
      _$FedServerInformationFromJson(json);

  Map<String, dynamic> toJson() => _$FedServerInformationToJson(this);

  @override
  List<Object?> get props => [baseUrl, serverName];
}

Create FedConfigurations

class FedConfigurations with EquatableMixin {
  final FedServerInformation fedServerInformation;
  final IdentityServerInformation? identityServerInformation;
  final String? authUrl;
  final LoginType? loginType;

  FedConfigurations({
    required this.tomServerInformation,
    this.identityServerInformation,
    this.authUrl,
    this.loginType,
  });

  @override
  List<Object?> get props =>
      [fedServerInformation, identityServerInformation, authUrl, loginType];
}

Convert response from .well-know to FedServerInformation

• Write func convert it in HomeserverSummaryExtensions: lib/domain/model/extensions/homeserver_summary_extensions.dart

FedServerInformation? get fedServer {
    if (discoveryInformation?.additionalProperties == null) {
      return null;
    }
    final fedServerJson = discoveryInformation
        ?.additionalProperties[FedServerInformation.fedServerKey];
    if (fedServerJson == null) {
      return null;
    }
    try {
      return FedServerInformation.fromJson(fedServerJson);
    } catch (e) {
      Logs().e('Failed to parse m.federated_identity_services from homeserver summary', e);
      return null;
    }
  }

Create FedConfigurationsRepository

abstract class FedConfigurationsRepository {
  Future<FedConfigurations> getFedConfigurations(String userId);

  Future<void> saveFedConfigurations(
    String userId,
    FedConfigurations fedConfigurations,
  );

  Future<void> deleteFedConfigurations(String userId);
}

Create new Fed dio in NetworkDI

class NetworkDI extends BaseDI {
  static const fedServerUrlInterceptorName = 'fedServerDynamicUrlInterceptor';
  static const fedServerDioName = 'fedServerDioName';
  static const fedDioClientName = 'fedServerDioClientName';

  void _bindInterceptor(GetIt get) { 
    get.registerLazySingleton(
      () => DynamicUrlInterceptors(),
      instanceName: fedServerUrlInterceptorName,
    );
  }

  void _bindDio(GetIt get) {
    _bindDioForFedServer(get);
  }

  void _bindDioForFedServer(GetIt Get) {}
}

[nqhhdev]

How to work with Fed server

Request Fed token

• Use URL {{identityServer}}_matrix/client/v3/user/{{mxid}}/openid/request_token to call get Fed Token information

Response

{
    "access_token": "pXoIqYPEUwRUTMUAkjWMMIgF",
    "token_type": "Bearer",
    "matrix_server_name": "stg.lin-saas.com",
    "expires_in": 3600
}

Create FedAuthorizationInterceptor to handle accessToken after call request Fed token

class FedAuthorizationInterceptor extends InterceptorsWrapper {
  FedAuthorizationInterceptor();

  String? _accessToken;

  set accessToken(String? accessToken) {
    _accessToken = accessToken;
  }

  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    options.headers[HttpHeaders.authorizationHeader] = _bearerToken;
    Logs().d('FedAuthorizationInterceptor::onRequest:accessToken: $_bearerToken');
    super.onRequest(options, handler);
  }

  String get _bearerToken => 'Bearer $_accessToken';
}