54 |
55 |
56 |
76 |
77 |
79 |
80 | 
2 |
3 | # at_hive_recovery
4 |
5 | **at_hive_recovery** tool for recovering corrupted hive boxes.
6 |
7 | Usage:
8 |
9 | ```
10 | dart bin/main.dart
4 |
5 | [](https://pub.dev/packages/at_repl)
6 | [](https://pub.dev/packages/at_repl/score)
7 | [](./LICENSE)
8 |
9 | A CLI tool for interacting with an atServer using the atProtocol.
10 |
11 | ### Getting Started
12 |
13 | Ensure you have your atSign keys. Keys are usually located in `$HOME/.atsign/keys`.
14 |
15 | If you don't have an atSign, visit here
2 |
3 | [](./LICENSE)
4 | [](https://securityscorecards.dev/viewer/?uri=github.com/atsign-foundation/at_tools&sort_by=check-score&sort_direction=desc)
5 | [](https://www.bestpractices.dev/projects/8121)
6 |
7 | ## at_tools
8 |
9 | This repository contains atProtocol tools for developers
10 | building atPlatform applications who wish to utilize the authentication
11 | methods:
12 |
13 | ### standalone tools
14 |
15 | [at_cli](./packages/at_cli) A command line tool to execute verbs on the atPlatform.
16 |
17 | [at_cram](./packages/at_cram) The challenge–response authentication mechanism of the
18 | atProtocol.
19 |
20 | [at_dump_atKeys](./packages/at_dump_atKeys) A command line tool to dump keys from a
21 | .atKeys file.
22 |
23 | [at_pkam](./packages/at_pkam) The public key authentication mechanism of the
24 | atProtocol.
25 |
26 | [at_ve_doctor](./packages/at_ve_doctor) A very simple way to test the status of the
27 | secondaries running in the Virtual Environment. Using the
28 | [at_server_status](https://pub.dev/packages/at_server_status) package.
29 |
30 | ### Quickly build tools
31 |
32 | Using melos, we can quickly build at_pkam, at_cram, at_cli, and at_repl via the
33 | following commands:
34 |
35 | ```bash
36 | dart pub get
37 | dart run melos run build-tools
38 | ```
39 |
40 | Then move the tools to a folder which you've exposed to the path for
41 | convenience, for example:
42 |
43 | ```bash
44 | cp ./build-tools/* ~/.local/bin/
45 | # or
46 | sudo cp ./build-tools/* /usr/local/bin/
47 | ```
48 |
49 |
--------------------------------------------------------------------------------
/packages/at_cram/bin/at_cram_single.dart:
--------------------------------------------------------------------------------
1 | import 'dart:convert';
2 | import 'dart:io';
3 | import 'package:args/args.dart';
4 | import 'package:crypto/crypto.dart';
5 |
6 | /// command-line usage
7 |
8 | /// (1)
9 | /// first compile this file (replace
2 |
3 | # Atsign Foundation Open Source Security Policies and Procedures
4 |
5 | This document outlines security procedures and general policies for the
6 | Atsign Foundation Open Source projects as found on
7 | https://github.com/atsign-foundation.
8 |
9 | * [Reporting a Vulnerability](#reporting-a-vulnerability)
10 | * [Disclosure Policy](#disclosure-policy)
11 |
12 | ## Reporting a Vulnerability
13 |
14 | The Atsign Foundation team and community take all security vulnerabilities
15 | seriously. Thank you for improving the security of our open source
16 | software. We appreciate your efforts and responsible disclosure and will
17 | make every effort to acknowledge your contributions.
18 |
19 | Report security vulnerabilities by emailing the Atsign security team at:
20 |
21 | security@atsign.com
22 |
23 | The lead maintainer will acknowledge your email within 24 hours, and will
24 | send a more detailed response within 48 hours indicating the next steps in
25 | handling your report. After the initial reply to your report, the security
26 | team will endeavor to keep you informed of the progress towards a fix and
27 | full announcement, and may ask for additional information or guidance.
28 |
29 | Please report security vulnerabilities in third-party modules to the person
30 | or team maintaining the module.
31 |
32 | ## Disclosure Policy
33 |
34 | When the security team receives a security bug report, they will assign it
35 | to a primary handler. This person will coordinate the fix and release
36 | process, involving the following steps:
37 |
38 | * Confirm the problem and determine the affected versions.
39 | * Audit code to find any potential similar problems.
40 | * Prepare fixes for all releases still under maintenance. These fixes
41 | will be released as fast as possible to pub.dev where applicable.
--------------------------------------------------------------------------------
/packages/at_cli/lib/src/command_line_parser.dart:
--------------------------------------------------------------------------------
1 | import 'package:args/args.dart';
2 |
3 | /// A class for taking a list of raw command line arguments and parsing out
4 | /// options and flags from them.
5 | class CommandLineParser {
6 | /// Parses [arguments], a list of command-line arguments, matches them against the
7 | /// flags and options defined by this parser, and returns the result.
8 | static var parser = ArgParser();
9 | static ArgResults? getParserResults(List
2 |
3 | ## at_cram
4 |
5 | The at_cram utility is used to create the authentication digest when connecting
6 | to a secondary server that does not yet have pkam authentication activated.
7 |
8 | When a secondary is started up for the first time it is started with a shared
9 | secret via the commandline. That shared secret is shared with the person who
10 | owns the atSign of the secondary. This is normally done on both the
11 | [atsign.com](atsign.com) website and when using
12 | [dess](https://github.com/atsign-foundation/dess) via the use of a QRCode.
13 |
14 | When using the [Virtual Environment](https://github.com/atsign-foundation/at_virtual_environment) (VE) the
15 | shared secrets can be found [here](https://github.com/atsign-foundation/at_tools/tree/trunk/at_cram/cramkeys)
16 | for each of the preconfigured atSigns in VE.
17 |
18 | The cram: atProtocol verb is only used to bootstrap a new secondary so that the public keys can be transfered to the secondary. Once the pkam keys have been set the cram process is disabled. The means that before the secondary is used for the atSigns data the cram is disabled and the pkam used going forward.
19 |
20 | To use the at_cram utility connect to a new secondary with a known shared secret, enter the from: verb
21 | and the atSign to authenticate as then use the cram: verb with the result of the at_cram binary.
22 | To use the at_cram tool run `dart bin/at_cram at_repl
36 |
39 |
40 |
49 |
50 |
2 |
3 | # Contributing guidelines
4 |
5 | We 💙 [Pull Requests](https://help.github.com/articles/about-pull-requests/)
6 | for fixing issues or adding features. Thanks for your contribution!
7 |
8 | Please read our [code of conduct](code_of_conduct.md), which is based on
9 | [](code_of_conduct.md)
10 |
11 |
12 | For small changes, especially documentation, you can simply use the "Edit" button
13 | to update the Markdown file, and start the
14 | [pull request](https://help.github.com/articles/about-pull-requests/) process.
15 | Use the preview tab in GitHub to make sure that it is properly
16 | formatted before committing. Please use conventional commits and follow the semantic PR format as documented
17 | [here](https://github.com/atsign-foundation/.github/blob/trunk/atGitHub.md#semantic-prs).
18 | A pull request will cause integration tests to run automatically, so please review
19 | the results of the pipeline and correct any mistakes that are reported.
20 |
21 | If you plan to contribute often or have a larger change to make, it is best to
22 | setup an environment for contribution, which is what the rest of these guidelines
23 | describe. The atsign-foundation GitHub organization's conventions and configurations are documented
24 | [here](https://github.com/atsign-foundation/.github/blob/trunk/atGitHub.md).
25 |
26 | ## Development Environment Setup
27 |
28 |
29 | ### Prerequisites
30 |
31 | ``` sh
32 | # show how to install the tools needed to work with the code here
33 | ```
34 |
35 |
36 | ### GitHub Repository Clone
37 |
38 | To prepare your dedicated GitHub repository:
39 |
40 | 1. Fork in GitHub https://github.com/atsign-foundation/at_tools
41 | 2. Clone *your forked repository* (e.g., `git clone git@github.com:yourname/at_tools`)
42 | 3. Set your remotes as follows:
43 |
44 | ```sh
45 | cd at_tools
46 | git remote add upstream git@github.com:atsign-foundation/at_tools.git
47 | git remote set-url upstream --push DISABLED
48 | ```
49 |
50 | Running `git remote -v` should give something similar to:
51 |
52 | ```text
53 | origin git@github.com:yourname/at_tools.git (fetch)
54 | origin git@github.com:yourname/at_tools.git (push)
55 | upstream git@github.com:atsign-foundation/at_tools.git (fetch)
56 | upstream DISABLED (push)
57 | ```
58 |
59 | The use of `upstream --push DISABLED` is to prevent those
60 | with `write` access to the main repository from accidentally pushing changes
61 | directly.
62 |
63 | ### Development Process
64 |
65 | 1. Fetch latest changes from main repository:
66 |
67 | ```sh
68 | git fetch upstream
69 | ```
70 |
71 | 1. Reset your fork's `trunk` branch to exactly match upstream `trunk`:
72 |
73 | ```sh
74 | git checkout trunk
75 | git reset --hard upstream/trunk
76 | git push --force
77 | ```
78 |
79 | **IMPORTANT**: Do this only once, when you start working on new feature as
80 | the commands above will completely overwrite any local changes in `trunk` content.
81 | 1. Edit, edit, edit, and commit your changes to Git:
82 |
83 | ```sh
84 | # edit, edit, edit
85 | git add *
86 | git commit -m 'A useful commit message'
87 | git push
88 | ```
89 |
90 | 1. How to run tests:
91 |
92 | ``` sh
93 | # explain tests here
94 | ```
95 |
96 | 1. Open a new Pull Request to the main repository using your `trunk` branch
--------------------------------------------------------------------------------
/packages/at_pkam/bin/main.dart:
--------------------------------------------------------------------------------
1 | import 'dart:convert';
2 | import 'dart:io';
3 | import 'dart:typed_data';
4 |
5 | import 'package:archive/archive_io.dart';
6 | import 'package:args/args.dart';
7 | import 'package:at_pkam/commandline_parser.dart';
8 | import 'package:at_pkam/pkam_constants.dart';
9 | import 'package:crypton/crypton.dart';
10 | import 'package:encrypt/encrypt.dart';
11 |
12 | var parser = ArgParser();
13 |
14 | Futureat_repl
35 |
38 |
39 |
48 |
49 |
53 |
56 |
65 |
66 |
67 |
86 |
87 |
89 |
90 | 404: Something's gone wrong :-(
54 | 55 |You've tried to visit a page that doesn't exist. Luckily this site 57 | has other pages.
58 |If you were looking for something specific, try searching: 59 |
62 | 63 | 64 |at_repl
35 |
38 |
39 |
48 |
49 |
53 |
54 |
61 |
65 |
66 |
67 |
68 |
69 |
70 |
71 |
72 |
73 |
74 |
75 |
76 |
77 |
78 |
98 |
99 |
113 |
114 |
55 |
58 |
59 |
60 | at_repl library 56 | 57 |
# activate at_repl
62 | $ dart pub global activate at_repl
63 | at_repl
35 |
38 |
39 |
48 |
49 |
53 |
54 |
55 |
79 |
80 |
81 |
82 |
95 |
96 |
97 |
98 |
117 |
118 |
120 |
121 | at_repl
56 |A CLI application that talks directly to the atPlatform.
57 |Getting Started
58 |Ensure you have you atSign keys, keys are usually located in "homeDirectory.atsign\keys".
59 |If you don't have an atSign, visit here https://my.atsign.com/login.
60 |If the CLI application is available on pub, activate globally via:
61 |dart pub global activate at_repl
62 | Or locally via:
64 |dart pub global activate --source=path <path to this package>
65 | Usage
67 |-a, user's atsign (REQUIRED) 68 | -r, root URL (defaults to root.atsign.org:64) 69 | -v, verbose 70 | -n, enforce namespaces (defaults to false)
71 |#example of full REPL command
72 | $ at_repl -a @xavierlin -r root.atsign.org:64 -v -n
73 |
74 | #example of shortened REPL command
75 | $ at_repl -a @xavierlin
76 |
77 | Libraries
83 |-
84 |
- 85 | at_repl 86 | 87 | 88 |
# activate at_repl 89 | $ dart pub global activate at_repl 90 |91 |
92 |
93 |
2 |
3 | # at_cli
4 |
5 | A command line tool to execute verbs on at platform.
6 |
7 | ### Building
8 |
9 | __Assumption__ - you have the [Dart SDK](https://dart.dev/get-dart) installed. The version should be >= 2.12.0 and <4.0.0.
10 |
11 | First fetch dependencies (as defined in pubspec.yaml):
12 |
13 | ```bash
14 | dart pub get
15 | ```
16 |
17 | It's now possible to run the command in the Dart VM:
18 |
19 | ```bash
20 | dart run bin/main.dart
21 | ```
22 |
23 | At which point it will print out some usage instructions:
24 |
25 | ```
26 | Usage:
27 | -a, --auth Set this flag if command needs auth to server
28 | -m, --mode Choose Authentication mode if auth required
29 | [cram, pkam]
30 | -f, --authKeyFile cram/pkam file path
31 | --atsign Current Atsign
32 | -c, --command The at command to execute
33 | -v, --verb The verb to execute
34 | -p, --public set to true if key has public access
35 | -k, --key key to update
36 | --value value of the key
37 | -w, --shared_with atsign to whom key is shared
38 | -b, --shared_by atsign who shared the key
39 | -r, --regex regex for scan
40 | ```
41 |
42 | If you're going to run `atcli` a lot then it makes sense to create a binary
43 | and copy it to somewhere on the PATH e.g.
44 |
45 | ```bash
46 | dart compile exe bin/main.dart -o ~/atcli
47 | sudo cp ~/atcli /usr/local/bin/
48 | ```
49 |
50 | Verify the following information in config.yaml file. Please provide valid values.
51 |
52 | ```
53 | root_server:
54 | # The port on which root server runs.
55 | port: 64
56 | host: 'root.atsign.org'
57 |
58 | auth:
59 | required: true # Authentication required for the Verb or not
60 | mode: cram # Mode of Authentication (cram or pkam)
61 | key_file_location: 'bin/@alice' # File path which contains PKAM/CRAM secret
62 | at_sign: '@alice'
63 | ```
64 |
65 | Also, we can provide auth related information from commandline as mentioned above.
66 |
67 | Here are some examples to execute verbs
68 |
69 | __scan__
70 | ```
71 | # Without Authentication
72 | dart run bin/main.dart -v scan
73 |
74 | #This command will return all the keys available publicly for atsign provided in config.yaml
75 | # Alternatively we can provide atSign from commandline as follows
76 | dart run bin/main.dart -v scan -a @alice
77 |
78 | #sample output
79 | [firstname@alice, location@alice, signing_publickey@alice]
80 | ```
81 | ```
82 | # With Authentication
83 | dart run bin/main.dart -v scan -a true
84 | or
85 | dart run bin/main.dart -v scan -a true -a @alice
86 |
87 | # This command will return all the keys available for @alice by authenticating using cram/pkam provided in config.yaml
88 |
89 | #sample output
90 | [@alice:signing_privatekey@alice, public:firstname@alice, public:location@alice, public:signing_publickey@alice]
91 |
92 | Note: We can provide Authenication mode using -m/--mode option, cram/pkam file path using -f/--authKeyFile options
93 | ```
94 | __update__
95 |
96 | Update verb is used to update/create a key with value.
97 | Update verb required authentication.
98 | ```
99 | # Update/Create a key 'firstname' with value as 'alice' which is private to alice
100 | dart run bin/main.dart -v update -k firtname --value alice -p false -a true
101 |
102 | # Sample output
103 | true
104 |
105 | # Update/Create a key 'lastname' with value as alice which is available publicly
106 | dart run bin/main.dart -v update -k firtname --value alice -p true -a true
107 |
108 | # Sample output
109 | true
110 | ```
111 | __lookup__
112 |
113 | Lookup verb is used to lookup particular key of an atSign. Lookup verb requires authentication.
114 | ```
115 | # To lookup bob email
116 | dart run bin/main.dart -v lookup -k email --atsign @bob -a true
117 |
118 | # Sample output
119 | bob@at.com
120 |
121 | # You can run command to lookup bob's email as follows
122 | dart run bin/main.dart -c lookup:email@bob -a true
123 |
124 | # Sample output
125 | bob@at.com
126 | ```
127 |
128 | __llookup__
129 |
130 | The "llookup" verb can be used to locally lookup keys stored on the secondary server. To execute Llookup authentication is required.
131 | ```
132 | # To llookup firstname@alice
133 | dart run bin/main.dart -v llookup -k firstname --atsign @alice -a true
134 |
135 | #sample output
136 | alice
137 |
138 | # Alternatively we can run command directly as follows
139 | dart run bin/main.dart -c llookup:firstname@alice -a true
140 |
141 | # sample output
142 | alice
143 | ```
144 |
145 | __plookup__
146 |
147 | The "plookup" verb, provides a proxied public lookups for a resolver that perhaps is behind a firewall. This will allow a resolver to contact an atServer and have the atServer lookup both public atSign handles information.
148 | ```
149 | # To lookup the value of public:location@alice
150 | dart run bin/main.dart -v plookup -k location --atsign @alice -a true
151 |
152 | # Sample output
153 | india
154 |
155 | # We can run plookup command directly as follows
156 | dart run bin/main.dart -c plookup:location@alice -a true
157 |
158 | # Sample output
159 | india
160 | ```
--------------------------------------------------------------------------------
/packages/at_dump_atKeys/README.md:
--------------------------------------------------------------------------------
1 |
2 |
3 | ## at_dump_atKeys
4 |
5 | A command line tool to dump keys from a .atKeys file
6 |
7 | ### Building
8 |
9 | __Assumption__ - you have the [Dart SDK](https://dart.dev/get-dart) installed. The version should be >= 2.12.0 and <4.0.0.
10 |
11 | First fetch dependencies (as defined in pubspec.yaml):
12 |
13 | ```bash
14 | dart pub get
15 | ```
16 |
17 | It's now possible to run the command in the Dart VM:
18 |
19 | ```bash
20 | dart run bin/main.dart
21 | ```
22 |
23 | At which point it will print out some usage instructions:
24 |
25 | ```
26 | Usage:
27 | dart bin/main.dart
28 | -p, --file_path .atKeys file path which contains keys
29 | ```
30 |
31 | Starting up the VM every time for a small command line app is a little slow,
32 | so it's better to create a compiled binary:
33 |
34 | ```bash
35 | dart compile exe bin/main.dart -o dump_atKeys
36 | ```
37 |
38 | The binary can now be run with `./dump_atKeys` along with appropriate arguments.
39 |
40 | ### Usage
41 |
42 | Run the tool against an atKeys file (in this case ~/demo.atKeys):
43 |
44 | ```bash
45 | dart run bin/main.dart -p ~/demo.atKeys
46 | ```
47 |
48 | or if using a compiled binary:
49 |
50 | ```bash
51 | ./dump_atKeys -p ~/demo.atKeys
52 | ```
53 |
54 | Which will give output like:
55 |
56 | ```
57 | pkamPublicKey: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAg1THrbmEpXMDXUtci4GBNaARF2ghWYz6tC5PcO8oyjqioDwlp7lVZcufhgZGD2Dd5j124vyx8t0qlTP/LObK8WvgvLOY5NqUCOgYBv0VufVzOr6xrsNKVEKC9GzMkMbUfFwBVYHeeIg3IKeGTyxB+qHQIAa2gLZCBKX8EsLTGliQmkv2J96umaFTsS/juwxw9nSVpsMIwCcg6hA3njVbjR1p5o9mZ3lVw57GOHzkdyGXXBgKzNvBRXBSDOkNCulxoixrydqWD8sLc8AERQoWCUwSWITTS0YE/jFL8fH2zWupjJ510JmoIf2L2MJsiFFUCtRIRTWSIHs1/cXZiIEvhQIDAQAB
58 |
59 | pkamPrivateKey: MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCDVMetuYSlcwNdS1yLgYE1oBEXaCFZjPq0Lk9w7yjKOqKgPCWnuVVly5+GBkYPYN3mPXbi/LHy3SqVM/8s5srxa+C8s5jk2pQI6BgG/RW59XM6vrGuw0pUQoL0bMyQxtR8XAFVgd54iDcgp4ZPLEH6odAgBraAtkIEpfwSwtMaWJCaS/Yn3q6ZoVOxL+O7DHD2dJWmwwjAJyDqEDeeNVuNHWnmj2ZneVXDnsY4fOR3IZdcGArM28FFcFIM6Q0K6XGiLGvJ2pYPywtzwARFChYJTBJYhNNLRgT+MUvx8fbNa6mMnnXQmagh/YvYwmyIUVQK1EhFNZIgezX9xdmIgS+FAgMBAAECggEAEq0z2FjRrFW23MWi25QHNAEXbSS52WpbHNSZJ45bVqcQCYmEMV4B7wAOJ5kszXMRG3USOyWEiO066Q0D9Pa9VafpxewkiicrdjjLcfL76/4j7O7BhgDvyRvMU8ZFMTGVdjn/VpGpeaqlbFdmmkvI9kOcvXE28wb4TIDuYBykuNI6twRqiaVd1LkKg9yoF0DGfSp8OHGWm/wz5wwnNYT6ofTbgV3gSGKOrLf4rC1swHh1VoNXiaYKQQFo2j23vGznC+hVJy8kAkSTMvRy4+SrZ+0MtYrNt0CI9n4hw79BNzwAd0kfJ5WCsYL6MaF8Giyym3Wl77KoiriwRF7cGCEnAQKBgQDWD+l1b6D8QCmrzxI1iZRoehfdlIlNviTxNks4yaDQ/tu6TC/3ySsRhKvwj7BqFYj2A6ULafeh08MfxpG0MfmJ+aJypC+MJixu/z/OXhQsscnR6avQtVLi9BIZV3EweyaD/yN/PB7IVLuhz6E6BV8kfNDb7UFZzrSSlvm1YzIdvQKBgQCdD5KVbcA88xkv/SrBpJcUME31TIR4DZPg8fSB+IDCnogSwXLxofadezH47Igc1CifLSQp4Rb+8sjVOTIoAXZKvW557fSQk3boR3aZ4CkheDznzjq0vY0qot4llkzHdiogaIUdPDwvYBwERzc73CO3We1pHs36bIz70Z3DRF5BaQKBgQC295jUARs4IVu899yXmEYa2yklAz4tDjajWoYHPwhPO1fysAZcJD3E1oLkttzSgB+2MD1VOTkpwEhLE74cqI6jqZV5qe7eOw7FvTT7npxd64UXAEUUurfjNz11HbGo/8pXDrB3o5qoHwzV7RPg9RByrqETKoMuUSk1FwjPSr9efQKBgAdC7w4Fkvu+aY20cMOfLnT6fsA2l3FNf2bJCPrxWFKnLbdgRkYxrMs/JOJTXT+n93DUj3V4OK3036AsEsuStbti4ra0b7g3eSnoE+2tVXl8q6Qz/rbYhKxR919ZgZc/OVdiPbVKUaYHFYSFHmKgHO6fM8DGcdOALUx/NoIOqSTxAoGBALUdiw8iyI98TFgmbSYjUj5id4MrYKXaR7ndS/SQFOBfJWVH09t5bTxXjKxKsK914/bIqEI71aussf5daOHhC03LdZIQx0ZcCdb2gL8vHNTQoqX75bLRN7J+zBKlwWjjrbhZCMLE/GtAJQNbpJ7jOrVeDwMAF8pK+Put9don44Gx
60 |
61 | encryptionPublicKey: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0sYjWt6TTikajY3HjvdN3sn2Ve3O+i84/gBrWPqhGNSdImz3W2l9dMSHm4wyixsxMSQaL+rECjwnvp3sRdW3M51sDCvWa06MLptvdrtnMjzDrvP45hUJY/i6WeDW8qeEOf9zuo+BLcQ3pkV1KZyhBj80OndLS/y00T8fYB9KnS5Z/iN7KW7Hxuv0isMPXxL1i8AZos7m5GuWq7CfRFKJIZ6vqYBUJCVSQCUVo1llyjElodSywcf1KjCvBOKuMPnUQCs+pKJt3QMFI0U7D+yinnlEdr6TBfOzMMPS3Du1LHpTGt7rqyxZrX8p4kpVb/CyL6wkelMuahHDOeNFBNyF0wIDAQAB
62 |
63 | encryptionPrivateKey: MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDSxiNa3pNOKRqNjceO903eyfZV7c76Lzj+AGtY+qEY1J0ibPdbaX10xIebjDKLGzExJBov6sQKPCe+nexF1bcznWwMK9ZrTowum292u2cyPMOu8/jmFQlj+LpZ4Nbyp4Q5/3O6j4EtxDemRXUpnKEGPzQ6d0tL/LTRPx9gH0qdLln+I3spbsfG6/SKww9fEvWLwBmizubka5arsJ9EUokhnq+pgFQkJVJAJRWjWWXKMSWh1LLBx/UqMK8E4q4w+dRAKz6kom3dAwUjRTsP7KKeeUR2vpMF87Mww9LcO7UselMa3uurLFmtfyniSlVv8LIvrCR6Uy5qEcM540UE3IXTAgMBAAECggEAfImMLE3k1cLdqJQEPIoNHb1RatZXfGXYk+QliW6VLzm5GrUttnpvIUZaJeNBngXUHAgL3RInATEn/q4LA/xSAhJa3Bou2DqSA5vd0VbLk9hpev82qqP1Z3d4jFCYUMoAC9DPTYUrO6J7iyfxIUQltK41qvH/sIdBQ327iS0UBihhiKg16BOKG4SoFJHZfhhL6m86+jnsaBTaAWb8hpa/Mwqs5eDHF78DHK8o+4Q6DufDi34nCwdxEexL3MFa9L0qGbQAqJshgDcJ6yxUzb5+tw3XXpiE0yG9aZ5gPaS2UgOYY1m2mmF4RjFSiLmKyN99H99ycA59enVFyfYh4SnuMQKBgQDq9IwkVyDkNxkaW6hyYMzBwNqId74JUNjXCWyzDJ58JWaNvFYYY4ujSCLTdfdugmVTIUjqXMVsxzq/e9jNaOj7u27/3inqn1VC88GFJJiUiLQcTP1T5ySP4jy5GVrhQ1zP8PtiRqE34emYfVY8OLa7bwf5CufgbL5RzKPrfIafKQKBgQDlpx8DoETRPE7FyZJg9xiUTyZmI/P6RmhCO86knbQa4hEWiCuEIiOheJQxdcW6yCNImbJNSEFUnpweiHEw4xdMmlpR4JDkvsGOyjLI6Y36Yxbi+AipvTuYZ/La7fuOeEjwD7OlgJmva2jEQL6GlhmTibgt5dfwzOiAP0gC4tXomwKBgQDAnZDSLfeSADV9LU0vz3mtEYxWOkw52OSbjWdmdd7ricHESnUOc3VDe9zJHLmnCBFHEE91im5zWfUoi8BVzT7LOIKsEpaseMjuJWUt4K2Rf2ygkuFPSnvn1SHQ4R9m8tGAy19a1upOJM9bKs1qe1ga2tBfc3havOtdpfVwFVtL2QKBgDFsPehx3V2KNQmrz6y+gLOqNQFWS3NZI6bdaCNVLSV78WF//J17G1/sqzfZuKvx1mYRbaXkHusvFzoa8wEqXiFGNpnYUlZoFw+7xCIo4T05hftilbqx1tl9xW4IOVL33/qJ5od/nZN68hkKNfaQ5wAxa0m1ZTuVXZP8CmtUleRxAoGAQcz+GcrzLybY8EMOhYRbb79H8tQ+SoFkTOmJV4ZQDxzg18dPd8+U3YaMp3QngxncOSpjSwsuqpw/SqxHBQE/v91uEzLfPPS2QJ5COBvXM2Y7PsSmMnukIOM0NrtU8MIonv+l7UsHDeCllqe5+uRPpBUUk2mljPVprXo0SDjQr1U=
64 |
65 | selfEncryptionKey: vR+w/lx9qitj/W2+SfFxbjeRM8VdaYGsxG6lxYCVQ0w=
66 | ```
--------------------------------------------------------------------------------
/packages/at_dump_atKeys/bin/generate_at_demo_data.dart:
--------------------------------------------------------------------------------
1 | import 'dart:convert';
2 | import 'dart:io';
3 | import 'dart:typed_data';
4 |
5 | import 'package:args/args.dart';
6 | import 'package:at_dump_atKeys/commandline_parser.dart';
7 | import 'package:crypton/crypton.dart';
8 | import 'package:encrypt/encrypt.dart';
9 |
10 | /// The script accepts the path to the directory that contains ".atKeys" file(s),
11 | /// Iterates through all the ".atKeys" files, decrypts the keys and writes to a file.
12 | ///
13 | /// Optionally accepts the following flags:
14 | /// * -o to set the destination directory to create the file. Defaults to the current directory
15 | /// * -f to set the filename. Defaults to at_demo_data.dart
16 | /// * -p This flag indicates to decrypt all keys or only PKAM keys. Defaults to "all"
17 | /// - When set to "all" all the keys are decrypted and written to output file.
18 | /// - Set the flag to "PKAM" to write only PKAM private key to the output file.
19 | /// For the end2end test in at_server, only PKAM keys are needed and for end2end tests
20 | /// in at_client all the keys are needed.
21 | ///
22 | /// Usage:
23 | ///
24 | /// The following command iterates through all the .atKeys file present in "/home/user" directory and
25 | /// writes the decrypted keys to an output file.
26 | ///
27 | /// ```dart
28 | /// dart bin/generate_at_demo_data.dart -d /home/user/atKeys
29 | ///```
30 | ///
31 | /// With optional flags:
32 | /// The below command places the output file in "/home/user/destDir" and creates a file with name "at_credentials.dart"
33 | /// ```dart
34 | /// dart bin/generate/at_demo_data.dart -d /home/user/atKeys -o /home/user/destDir -f at_credentials.dart
35 | /// ```
36 |
37 | Future
2 |
3 | # The Atsign Foundation Code of Conduct
4 |
5 | Based on
6 | [](code_of_conduct.md)
7 |
8 | ## Our Pledge
9 |
10 | We as members, contributors, and leaders pledge to make participation in our
11 | community a harassment-free experience for everyone, regardless of age, body
12 | size, visible or invisible disability, ethnicity, sex characteristics, gender
13 | identity and expression, level of experience, education, socio-economic status,
14 | nationality, personal appearance, race, caste, color, religion, or sexual identity
15 | and orientation.
16 |
17 | We pledge to act and interact in ways that contribute to an open, welcoming,
18 | diverse, inclusive, and healthy community.
19 |
20 | ## Our Standards
21 |
22 | Examples of behavior that contributes to a positive environment for our
23 | community include:
24 |
25 | * Demonstrating empathy and kindness toward other people
26 | * Being respectful of differing opinions, viewpoints, and experiences
27 | * Giving and gracefully accepting constructive feedback
28 | * Accepting responsibility and apologizing to those affected by our mistakes,
29 | and learning from the experience
30 | * Focusing on what is best not just for us as individuals, but for the
31 | overall community
32 |
33 | Examples of unacceptable behavior include:
34 |
35 | * The use of sexualized language or imagery, and sexual attention or
36 | advances of any kind
37 | * Trolling, insulting or derogatory comments, and personal or political attacks
38 | * Public or private harassment
39 | * Publishing others' private information, such as a physical or email
40 | address, without their explicit permission
41 | * Other conduct which could reasonably be considered inappropriate in a
42 | professional setting
43 |
44 | ## Enforcement Responsibilities
45 |
46 | Community leaders are responsible for clarifying and enforcing our standards of
47 | acceptable behavior and will take appropriate and fair corrective action in
48 | response to any behavior that they deem inappropriate, threatening, offensive,
49 | or harmful.
50 |
51 | Community leaders have the right and responsibility to remove, edit, or reject
52 | comments, commits, code, wiki edits, issues, and other contributions that are
53 | not aligned to this Code of Conduct, and will communicate reasons for moderation
54 | decisions when appropriate.
55 |
56 | ## Scope
57 |
58 | This Code of Conduct applies within all community spaces, and also applies when
59 | an individual is officially representing the community in public spaces.
60 | Examples of representing our community include using an official e-mail address,
61 | posting via an official social media account, or acting as an appointed
62 | representative at an online or offline event.
63 |
64 | ## Enforcement
65 |
66 | Instances of abusive, harassing, or otherwise unacceptable behavior may be
67 | reported to the community leaders responsible for enforcement at
68 | conduct@atsign.com.
69 | All complaints will be reviewed and investigated promptly and fairly.
70 |
71 | All community leaders are obligated to respect the privacy and security of the
72 | reporter of any incident.
73 |
74 | ## Enforcement Guidelines
75 |
76 | Community leaders will follow these Community Impact Guidelines in determining
77 | the consequences for any action they deem in violation of this Code of Conduct:
78 |
79 | ### 1. Correction
80 |
81 | **Community Impact**: Use of inappropriate language or other behavior deemed
82 | unprofessional or unwelcome in the community.
83 |
84 | **Consequence**: A private, written warning from community leaders, providing
85 | clarity around the nature of the violation and an explanation of why the
86 | behavior was inappropriate. A public apology may be requested.
87 |
88 | ### 2. Warning
89 |
90 | **Community Impact**: A violation through a single incident or series
91 | of actions.
92 |
93 | **Consequence**: A warning with consequences for continued behavior. No
94 | interaction with the people involved, including unsolicited interaction with
95 | those enforcing the Code of Conduct, for a specified period of time. This
96 | includes avoiding interactions in community spaces as well as external channels
97 | like social media. Violating these terms may lead to a temporary or
98 | permanent ban.
99 |
100 | ### 3. Temporary Ban
101 |
102 | **Community Impact**: A serious violation of community standards, including
103 | sustained inappropriate behavior.
104 |
105 | **Consequence**: A temporary ban from any sort of interaction or public
106 | communication with the community for a specified period of time. No public or
107 | private interaction with the people involved, including unsolicited interaction
108 | with those enforcing the Code of Conduct, is allowed during this period.
109 | Violating these terms may lead to a permanent ban.
110 |
111 | ### 4. Permanent Ban
112 |
113 | **Community Impact**: Demonstrating a pattern of violation of community
114 | standards, including sustained inappropriate behavior, harassment of an
115 | individual, or aggression toward or disparagement of classes of individuals.
116 |
117 | **Consequence**: A permanent ban from any sort of public interaction within
118 | the community.
119 |
120 | ## Attribution
121 |
122 | This Code of Conduct is adapted from the [Contributor Covenant][homepage],
123 | version 2.0, available at
124 | [https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
125 |
126 | Community Impact Guidelines were inspired by
127 | [Mozilla's code of conduct enforcement ladder][Mozilla CoC].
128 |
129 | For answers to common questions about this code of conduct, see the FAQ at
130 | [https://www.contributor-covenant.org/faq][FAQ]. Translations are available
131 | at [https://www.contributor-covenant.org/translations][translations].
132 |
133 | [homepage]: https://www.contributor-covenant.org
134 | [v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
135 | [Mozilla CoC]: https://github.com/mozilla/diversity
136 | [FAQ]: https://www.contributor-covenant.org/faq
137 | [translations]: https://www.contributor-covenant.org/translations
138 |
--------------------------------------------------------------------------------
/packages/at_repl/lib/features/inspect_notifications.dart:
--------------------------------------------------------------------------------
1 | import 'dart:io';
2 | import 'dart:convert';
3 | import 'package:io/ansi.dart';
4 | import '../interactive_session.dart';
5 |
6 | class InspectNotificationsSession implements InteractiveSession {
7 | final List
2 |
3 | ## at_pkam
4 |
5 | A command line tool to create PKAM authentication tokens.
6 |
7 | ### Building
8 |
9 | __Assumption__ - you have the [Dart SDK](https://dart.dev/get-dart) installed.
10 | The version should be >= 2.12.0 and <4.0.0.
11 |
12 | First fetch dependencies (as defined in pubspec.yaml):
13 |
14 | ```bash
15 | dart pub get
16 | ```
17 |
18 | It's now possible to run the command in the Dart VM:
19 |
20 | ```bash
21 | dart run bin/main.dart
22 | ```
23 |
24 | At which point it will print out some usage instructions:
25 |
26 | ```
27 | FormatException: ArgParserException
28 | -p, --file_path .keys or .zip file path which contains keys
29 | -r, --from_response from:@atSign response
30 | -a, --aes_key aes key file path
31 | (defaults to "")
32 | ```
33 |
34 | Starting up the VM every time for a small command line app is a little slow,
35 | so it's better to create a compiled binary:
36 |
37 | ```bash
38 | dart compile exe bin/main.dart -o pkam
39 | ```
40 |
41 | The binary can now be run with `./pkam` along with appropriate arguments.
42 |
43 | ### Usage
44 |
45 | The PKAM tool is used to generate an authentication token to sign into an
46 | @platform secondary server. You're going to need:
47 |
48 | * The name of the secondary e.g. @turingcomplete
49 | * The address and port of the secondary e.g. turingcomplete.mydomain.com:6565
50 | * Keys for the secondary generated during activation e.g. @turingcomplete_key.atKeys
51 |
52 | #### Connect to the secondary with OpenSSL
53 |
54 | __Assumption__ - you have [OpenSSL](https://www.openssl.org/) installed.
55 |
56 | ```bash
57 | openssl s_client -ign_eof turingcomplete.mydomain.com:6565
58 | ```
59 |
60 | There will then follow a bunch of certificate and handshake information like:
61 |
62 | ```
63 | CONNECTED(00000003)
64 | depth=2 C = US, O = Internet Security Research Group, CN = ISRG Root X1
65 | verify return:1
66 | depth=1 C = US, O = Let's Encrypt, CN = R3
67 | verify return:1
68 | depth=0 CN = turingcomplete.mydomain.com
69 | verify return:1
70 | ---
71 | Certificate chain
72 | 0 s:CN = turingcomplete.mydomain.com
73 | i:C = US, O = Let's Encrypt, CN = R3
74 | 1 s:C = US, O = Let's Encrypt, CN = R3
75 | i:C = US, O = Internet Security Research Group, CN = ISRG Root X1
76 | 2 s:C = US, O = Internet Security Research Group, CN = ISRG Root X1
77 | i:O = Digital Signature Trust Co., CN = DST Root CA X3
78 | ---
79 | Server certificate
80 | -----BEGIN CERTIFICATE-----
81 | MIIFKDCCBBCgAwIBAgISAwjRI5/zjWcPXyhPKz1sLdrKMA0GCSqGSIb3DQEBCwUA
82 | MDIxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1MZXQncyBFbmNyeXB0MQswCQYDVQQD
83 | EwJSMzAeFw0yMTA2MDExMTMyMTBaFw0yMTA4MzAxMTMyMTBaMBwxGjAYBgNVBAMT
84 | EWRlc3MuamF2YWdvbmUub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
85 | AQEAxHfYduxaBmQbS/SvmJY1rUoyzG5sr0H7M95sSwGyMcnpULEGq54g5+fSumCI
86 | 57OlC12T2skkq+Bz3I6HPppTHFLyJ1vzxZmlPRJhemc+lttnaDVI2Jnx/1IIlN3k
87 | D8VOCJq0uGHX0NVjERdAhYaroAlsAC4fulHHiArO0uq0KPOjmaHvhZU2gfv0g8w2
88 | uRiebwg0BQSkO5nY+8CEvnPwoW10dkP2EERZ3sk4iJscJWxK1u5qaZfUXu2aA23I
89 | s5u2MNKxCEPz97EBC0qAcJcgtaS9TBJhS0MFD3NhmmR+NHNJ3OollOfDOVNxZRyi
90 | fbQWnmB4/Xc6w1qwcSxOlQz8CQIDAQABo4ICTDCCAkgwDgYDVR0PAQH/BAQDAgWg
91 | MB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcDAjAMBgNVHRMBAf8EAjAAMB0G
92 | A1UdDgQWBBQAr+DwphsaqG0vRD9MsL38VqU3JTAfBgNVHSMEGDAWgBQULrMXt1hW
93 | y65QCUDmH6+dixTCxjBVBggrBgEFBQcBAQRJMEcwIQYIKwYBBQUHMAGGFWh0dHA6
94 | Ly9yMy5vLmxlbmNyLm9yZzAiBggrBgEFBQcwAoYWaHR0cDovL3IzLmkubGVuY3Iu
95 | b3JnLzAcBgNVHREEFTATghFkZXNzLmphdmFnb25lLm9yZzBMBgNVHSAERTBDMAgG
96 | BmeBDAECATA3BgsrBgEEAYLfEwEBATAoMCYGCCsGAQUFBwIBFhpodHRwOi8vY3Bz
97 | LmxldHNlbmNyeXB0Lm9yZzCCAQQGCisGAQQB1nkCBAIEgfUEgfIA8AB2AG9Tdqwx
98 | 8DEZ2JkApFEV/3cVHBHZAsEAKQaNsgiaN9kTAAABecePV2MAAAQDAEcwRQIgf1kf
99 | G7TYMivat36rY10ofYf6VURYwJMTENKSQWKYK6ICIQDhBDBbVWzhK9NiKloTWWpi
100 | ABV3FJqgUqAI+IN9zQBSdAB2APZclC/RdzAiFFQYCDCUVo7jTRMZM7/fDC8gC8xO
101 | 8WTjAAABecePVzQAAAQDAEcwRQIgfPT+NMBjqeCEXpWuhAm/JBfEP3zJEqn1ha7Z
102 | /6YOrG4CIQDYcgMZYN3BPS1G97sa5bKyeIk7Ph7ZXGVWLLd3+rS0UTANBgkqhkiG
103 | 9w0BAQsFAAOCAQEALPibZueYDjXzbZQXYbCnYeZJU+u6jjEOgJOP/9GyN5BM96o/
104 | 2U4cg5aOSAFrG3T3bHzSvcWws68bqwvAd1Z3+6ZMzERd/ecLCQ3BWsio5kDlbxmk
105 | eFN3C1HUDAeXahpOaAAXPtWTrNZtE5fQMM5ZY7dOZSArnzUPaHM3BYy8zzKKu4fD
106 | N6UjKBOEvc3XwkP739FjEdHfaHckaWwQGuPSYcTO6vtQ307+it1tWV1+9vn0uswx
107 | 1BN7WSzRQoQcPGmrcpO3vgt4O+5CXk0xTtyabMGeTgGmpadIotnpvbld+W4N+p4P
108 | xJQgdx1Vh8aTNBDKsJTmj3a6rckwdtHUBpj6qg==
109 | -----END CERTIFICATE-----
110 | subject=CN = turingcomplete.mydomain.com
111 |
112 | issuer=C = US, O = Let's Encrypt, CN = R3
113 |
114 | ---
115 | No client certificate CA names sent
116 | Requested Signature Algorithms: ECDSA+SHA256:RSA-PSS+SHA256:RSA+SHA256:ECDSA+SHA384:RSA-PSS+SHA384:RSA+SHA384:RSA-PSS+SHA512:RSA+SHA512:RSA+SHA1
117 | Shared Requested Signature Algorithms: ECDSA+SHA256:RSA-PSS+SHA256:RSA+SHA256:ECDSA+SHA384:RSA-PSS+SHA384:RSA+SHA384:RSA-PSS+SHA512:RSA+SHA512
118 | Peer signing digest: SHA256
119 | Peer signature type: RSA-PSS
120 | Server Temp Key: X25519, 253 bits
121 | ---
122 | SSL handshake has read 4541 bytes and written 419 bytes
123 | Verification: OK
124 | ---
125 | New, TLSv1.3, Cipher is TLS_AES_256_GCM_SHA384
126 | Server public key is 2048 bit
127 | Secure Renegotiation IS NOT supported
128 | Compression: NONE
129 | Expansion: NONE
130 | No ALPN negotiated
131 | Early data was not sent
132 | Verify return code: 0 (ok)
133 | ---
134 | ---
135 | Post-Handshake New Session Ticket arrived:
136 | SSL-Session:
137 | Protocol : TLSv1.3
138 | Cipher : TLS_AES_256_GCM_SHA384
139 | Session-ID: 620EB882C045BA493B48D36D13CDE0CD65C83EBF0ACA471566C0EB197383AA5C
140 | Session-ID-ctx:
141 | Resumption PSK: 73465DE8E3702D9633D80008BC5B62B8819CB9CFA1A0E7C1EA9DCA9709096F3162A83AD3BB0699DBF2ECC71787659600
142 | PSK identity: None
143 | PSK identity hint: None
144 | SRP username: None
145 | TLS session ticket lifetime hint: 172800 (seconds)
146 | TLS session ticket:
147 | 0000 - de 6a 37 8d 80 10 d5 ba-53 b5 68 78 3f 6d 39 c5 .j7.....S.hx?m9.
148 | 0010 - 9c e7 3f 54 e4 0d bb d7-3f 2a bf a3 4f 4c 40 09 ..?T....?*..OL@.
149 | 0020 - 44 77 83 c6 97 8d 68 eb-7c 19 e9 6d a7 58 aa 1a Dw....h.|..m.X..
150 | 0030 - 06 af 8d 02 bf c5 88 e1-9d a8 28 94 cb 92 e1 6d ..........(....m
151 | 0040 - f9 01 78 e1 dd b9 f5 0e-0b 0c 26 d8 0e 47 21 f5 ..x.......&..G!.
152 | 0050 - c7 9e d6 b6 b9 7a 64 a8-96 44 7f 81 e2 a8 75 04 .....zd..D....u.
153 | 0060 - e9 65 8f 20 da 1e 4e a4-0d b4 4f dd eb 2e a8 68 .e. ..N...O....h
154 | 0070 - 84 30 b3 17 23 a7 51 c2-c4 7d 07 2e 0f c4 0a 23 .0..#.Q..}.....#
155 | 0080 - 4e 97 e1 6e 69 1e c7 57-c2 e5 0d 8f 69 35 09 a6 N..ni..W....i5..
156 | 0090 - 79 ee 75 4f 09 43 a2 5e-17 8c 23 b4 8e 9e bc 7c y.uO.C.^..#....|
157 | 00a0 - f7 ca 6b 79 e1 3d 17 d2-3d 08 f4 68 4d 78 dc 68 ..ky.=..=..hMx.h
158 |
159 | Start Time: 1622826331
160 | Timeout : 7200 (sec)
161 | Verify return code: 0 (ok)
162 | Extended master secret: no
163 | Max Early Data: 0
164 | ---
165 | read R BLOCK
166 | ---
167 | Post-Handshake New Session Ticket arrived:
168 | SSL-Session:
169 | Protocol : TLSv1.3
170 | Cipher : TLS_AES_256_GCM_SHA384
171 | Session-ID: 57334F5145A174B8F8E1252068F4B42DFEAB6F823E1B6E4B507B41DEB97AC070
172 | Session-ID-ctx:
173 | Resumption PSK: D52439A67A5398787A089F8DFFB7D44EF469E7DD989E5ADA2EC78DFE80B0FFFB1B7CB0EB87564E716ECC9F6D826E377F
174 | PSK identity: None
175 | PSK identity hint: None
176 | SRP username: None
177 | TLS session ticket lifetime hint: 172800 (seconds)
178 | TLS session ticket:
179 | 0000 - de 6a 37 8d 80 10 d5 ba-53 b5 68 78 3f 6d 39 c5 .j7.....S.hx?m9.
180 | 0010 - 4f 0a 49 1f b5 f1 f0 d9-65 66 af 84 63 ee b6 63 O.I.....ef..c..c
181 | 0020 - 59 63 26 5a 66 f7 18 c1-2d f4 b3 21 46 60 22 9d Yc&Zf...-..!F`".
182 | 0030 - 75 b4 84 dd 87 40 6d bd-34 36 e1 52 12 50 c8 07 u....@m.46.R.P..
183 | 0040 - 26 49 9a 9b 9d bc c6 5d-88 e5 99 56 ae 2f d8 d6 &I.....]...V./..
184 | 0050 - 52 9f 22 a7 0d 50 8c cc-a9 90 1e bc 4e 6d 04 83 R."..P......Nm..
185 | 0060 - 15 13 37 4c 9c 1f 8c ce-05 e0 93 7e bf 92 98 e3 ..7L.......~....
186 | 0070 - d5 f5 52 71 ae ee 53 29-1c a0 62 29 c7 b7 a4 d9 ..Rq..S)..b)....
187 | 0080 - 30 71 0b e1 8d 67 b1 9d-de 7d 9d 58 a8 db c3 31 0q...g...}.X...1
188 | 0090 - 2f dc db ba 2b b1 79 47-67 af e8 13 d2 c1 ab 34 /...+.yGg......4
189 | 00a0 - d3 55 7a 3e 5d 1f eb 34-b3 27 24 26 b5 8a 69 ec .Uz>]..4.'$&..i.
190 |
191 | Start Time: 1622826331
192 | Timeout : 7200 (sec)
193 | Verify return code: 0 (ok)
194 | Extended master secret: no
195 | Max Early Data: 0
196 | ---
197 | read R BLOCK
198 | ```
199 |
200 | Culminating in an `@` prompt. At the prompt initiate the authentication process:
201 |
202 | ```
203 | from:@turingcomplete
204 | ```
205 |
206 | This will result in a response like:
207 |
208 | ```
209 | data:_82a2a0e5-9ad4-4f71-99f7-0cdd3798c7d0@turingcomplete:037e245d-34a6-4470-8764-992419a6c2fe
210 | ```
211 |
212 | Copy the response after `data:` and use it in the PKAM tool (__Assumption__ you
213 | have two sessions running, one for OpenSSL and the other for PKAM):
214 |
215 | ```
216 | ./pkam -p ~/@turingcomplete_key.atKeys -r \
217 | _82a2a0e5-9ad4-4f71-99f7-0cdd3798c7d0@turingcomplete:037e245d-34a6-4470-8764-992419a6c2fe
218 | ```
219 |
220 | __Assumption__ - your keys file has been copied to the HOME directory.
221 |
222 | PKAM will generate a response like:
223 |
224 | ```
225 | klW5RKSA6IevZJhR4Ig0rqqxbGt1f5G9Oa8yw7y/+AMTlu6LN8KUGvPTqc0EP9T0zUjxCVLBqvvD2e0ugRuarigEmQl0vktb7d7Vp3Bve6J+EI8rKhTDEzhe1XfN0LJTov1Gpo6DzYHq8bnP/4APNxnKPXS+ls5aIXh/I8yvxlO90+CHxyjjsMRm2c33eD+0vwGuGq+X+wT/YOU4TzAllIKlxHlA5kehTgS5WGinl3A8WG5pKE/+gFu3SRg/5sFwKf2E8DyYQaGRMuyMbOfLg4c3NTODyyMxZWx9bc2gtJ/kC52ngsPyBS3X0eyt1BSZliX/NeqTVTEWzMZMiOcf9w==
226 | ```
227 |
228 | Go back to the openssl session and prefix `pkam:` to the response:
229 |
230 | ```
231 | pkam:klW5RKSA6IevZJhR4Ig0rqqxbGt1f5G9Oa8yw7y/+AMTlu6LN8KUGvPTqc0EP9T0zUjxCVLBqvvD2e0ugRuarigEmQl0vktb7d7Vp3Bve6J+EI8rKhTDEzhe1XfN0LJTov1Gpo6DzYHq8bnP/4APNxnKPXS+ls5aIXh/I8yvxlO90+CHxyjjsMRm2c33eD+0vwGuGq+X+wT/YOU4TzAllIKlxHlA5kehTgS5WGinl3A8WG5pKE/+gFu3SRg/5sFwKf2E8DyYQaGRMuyMbOfLg4c3NTODyyMxZWx9bc2gtJ/kC52ngsPyBS3X0eyt1BSZliX/NeqTVTEWzMZMiOcf9w==
232 | ```
233 |
234 | Should result in:
235 |
236 | ```
237 | data:success
238 | @turingcomplete@
239 | ```
240 |
241 | At which point commands can be issued e.g. to scan for another secondary:
242 |
243 | ```
244 | scan:@bletchleycolossus
245 | ```
--------------------------------------------------------------------------------
/packages/at_repl/doc/api/static-assets/styles.css:
--------------------------------------------------------------------------------
1 | .light-theme {
2 | /*background-color body, listdropdown*/
3 | --main-bg-color: #fff;
4 | /*header id-tittle*/
5 | --main-header-color: #eeeeee;
6 | /*package-name*/
7 | --main-sidebar-color: #727272;
8 | /*section-title and section subtitle, desc markdown(body, dd, h3), header a*/
9 | --main-text-color: #111111;
10 | /*typehead search-box*/
11 | --main-search-bar: #fff;
12 | /* scrollbar-thumb */
13 | --main-scrollbar-color: #CCC;
14 | /* footer */
15 | --main-footer-background: #111111;
16 | /*header text color*/
17 | --main-h-text: black;
18 | /* hyperlinks*/
19 | --main-hyperlinks-color: #0175C2;
20 | /*search background*/
21 | --main-search-background: transparent;
22 |
23 | /*code snippets*/
24 | --main-code-bg: #f8f8f8;
25 | --main-keyword-color: #333;
26 | --main-tag-color: #000080;
27 | --main-section-color: #900;
28 | --main-comment-color: #998;
29 | --main-var-color: #008080;
30 | --main-string-color: #d14;
31 |
32 | --main-number-filter: invert(0%);
33 | --main-icon-color: black;
34 | }
35 |
36 | .dark-theme {
37 | /*background-color body, listdropdown*/
38 | --main-bg-color: #10161E;
39 | /*header id-tittle*/
40 | --main-header-color: #1C2834;
41 | /*package-name*/
42 | --main-sidebar-color: #fff;
43 | /*section-title and section subtitle, desc markdown(body, dd, h3), header a*/
44 | --main-text-color: #fff;
45 | /*typehead search-box*/
46 | --main-search-bar: #454545;
47 | /* scrollbar-thumb */
48 | --main-scrollbar-color: #5f6368;
49 | /* footer */
50 | --main-footer-background: #27323a;
51 | /* hyperlinks*/
52 | --main-hyperlinks-color: #00D2FA;
53 | /*search background*/
54 | --main-search-background: black;
55 |
56 | /*code snippets*/
57 | --main-code-bg: #10161E;
58 | --main-keyword-color: white;
59 | --main-tag-color: #00D2FA;
60 | --main-section-color: #FF2D64;
61 | --main-comment-color: #909CC3;
62 | --main-var-color: #55A09B;
63 | --main-string-color: #FF2D64;
64 |
65 | --main-number-filter: invert(100%);
66 | --main-icon-color: white;
67 | }
68 |
69 | #theme {
70 | display: none;
71 | }
72 |
73 | #theme-button {
74 | position: absolute;
75 | right: 30px;
76 | height: 24px;
77 | }
78 |
79 | #theme-button .material-symbols-outlined {
80 | color: var(--main-icon-color);
81 | user-select: none;
82 | cursor: pointer;
83 | }
84 |
85 | .light-theme #light-theme-button {
86 | display: none;
87 | }
88 |
89 | .dark-theme #dark-theme-button {
90 | display: none;
91 | }
92 |
93 | /*
94 | Only show images that fit their theme using GitHub's syntax, see:
95 | https://github.blog/changelog/2021-11-24-specify-theme-context-for-images-in-markdown/
96 | */
97 | .dark-theme img[src$="#gh-light-mode-only"] {
98 | display: none;
99 | }
100 |
101 | .light-theme img[src$="#gh-dark-mode-only"] {
102 | display: none;
103 | }
104 |
105 | /* for layout */
106 | html,
107 | body {
108 | margin: 0;
109 | padding: 0;
110 | height: 100%;
111 | width: 100%;
112 | overflow: hidden;
113 | box-sizing: border-box;
114 | }
115 |
116 | *, *:before, *:after {
117 | box-sizing: inherit;
118 | }
119 |
120 | body {
121 | display: flex;
122 | flex-direction: column;
123 | -webkit-overflow-scrolling: touch;
124 | }
125 |
126 | header {
127 | flex: 0 0 50px;
128 | display: flex;
129 | flex-direction: row;
130 | align-items: center;
131 | padding-left: 30px;
132 | padding-right: 30px;
133 | background-color: var(--main-header-color);
134 | }
135 |
136 | header ol {
137 | list-style: none;
138 | margin: 0;
139 | padding: 0;
140 | }
141 |
142 | header ol li {
143 | display: inline;
144 | }
145 |
146 | header form {
147 | display: flex;
148 | flex: 1;
149 | justify-content: flex-end;
150 | }
151 |
152 | header#header-search-sidebar {
153 | height: 50px;
154 | margin-bottom: 25px;
155 | }
156 |
157 | footer {
158 | flex: 0 0 16px;
159 | text-align: center;
160 | padding: 16px 20px;
161 | }
162 |
163 | main {
164 | flex: 1;
165 | display: flex;
166 | flex-direction: row;
167 | padding: 20px;
168 | min-height: 0;
169 | }
170 |
171 | .sidebar-offcanvas-left {
172 | flex: 0 1 230px;
173 | order: 1;
174 | overflow-y: scroll;
175 | padding: 20px 0 15px 30px;
176 | margin: 5px 20px 0 0;
177 | }
178 |
179 | ::-webkit-scrollbar-button{ display: none; height: 13px; border-radius: 0; background-color: #AAA; }
180 | ::-webkit-scrollbar-button:hover{ background-color: #AAA; }
181 | ::-webkit-scrollbar-thumb{ background-color: var(--main-scrollbar-color); }
182 | ::-webkit-scrollbar-thumb:hover{ background-color: var(--main-scrollbar-color); }
183 | ::-webkit-scrollbar{ width: 4px; }
184 |
185 | .main-content::-webkit-scrollbar{ width: 8px; }
186 |
187 | .main-content {
188 | flex: 1;
189 | order: 2;
190 | overflow-y: scroll;
191 | padding: 10px 20px 0 20px;
192 | }
193 |
194 | .sidebar-offcanvas-right {
195 | flex: 0 1 12em;
196 | order: 3;
197 | overflow-y: scroll;
198 | padding: 20px 15px 15px 15px;
199 | margin-top: 5px;
200 | margin-right: 20px;
201 | }
202 | /* end for layout */
203 |
204 | body {
205 | -webkit-text-size-adjust: 100%;
206 | overflow-x: hidden;
207 | font-family: Roboto, sans-serif;
208 | font-size: 16px;
209 | line-height: 1.42857143;
210 | color: var(--main-text-color);
211 | background-color: var(--main-bg-color);
212 | }
213 |
214 | nav.navbar {
215 | background-color: inherit;
216 | min-height: 50px;
217 | border: 0;
218 | }
219 |
220 | @media (max-width: 840px) {
221 | .hidden-xs {
222 | display: none !important;
223 | }
224 | }
225 |
226 | @media (min-width: 841px) {
227 | .hidden-l {
228 | display: none !important;
229 | }
230 | }
231 |
232 | nav.navbar .row {
233 | padding-top: 8px;
234 | }
235 |
236 | nav .container {
237 | white-space: nowrap;
238 | }
239 |
240 | header {
241 | background-color: var(--main-header-color);
242 | box-shadow: 0 3px 5px rgba(0,0,0,0.1);
243 | }
244 |
245 | .pre {
246 | border: 1px solid #ddd;
247 | font-size: 14px;
248 | }
249 |
250 | .hljs-string, .hljs-doctag {
251 | color: var(--main-string-color);
252 | }
253 |
254 | .hljs-number, .hljs-literal, .hljs-variable, .hljs-template-variable, .hljs-tag .hljs-attr {
255 | color: var(--main-var-color);
256 | }
257 |
258 | .hljs-comment, .hljs-quote {
259 | color: var(--main-comment-color);
260 | font-style: italic;
261 | }
262 |
263 | .hljs-title, .hljs-section, .hljs-selector-id {
264 | color: var(--main-section-color);
265 | font-weight: bold;
266 | }
267 |
268 | .hljs-tag, .hljs-name, .hljs-attribute {
269 | color: var(--main-tag-color);
270 | font-weight: normal;
271 | }
272 |
273 | .hljs-keyword, .hljs-selector-tag, .hljs-subst {
274 | color: var(--main-keyword-color);
275 | font-weight: bold;
276 | }
277 |
278 | .hljs {
279 | display: block;
280 | overflow-x: auto;
281 | padding: 0.5em;
282 | color: var(--main-text-color);
283 | background: var(--main-code-bg);
284 | }
285 |
286 | a {
287 | text-decoration: none;
288 | }
289 |
290 | section {
291 | margin-bottom: 36px;
292 | }
293 |
294 | dl {
295 | margin: 0;
296 | }
297 |
298 | h1,
299 | h2,
300 | h3,
301 | h4,
302 | h5,
303 | h6 {
304 | font-family: Roboto, sans-serif;
305 | font-weight: 400;
306 | margin-top: 1.5em;
307 | color: var(--main-text-color);
308 | }
309 |
310 | h1.title {
311 | overflow: hidden;
312 | text-overflow: ellipsis;
313 | }
314 |
315 | h1 {
316 | font-size: 37px;
317 | margin-top: 0;
318 | margin-bottom: 0.67em;
319 | }
320 |
321 | h2 {
322 | font-size: 28px;
323 | }
324 |
325 | h5 {
326 | font-size: 16px;
327 | }
328 |
329 | p {
330 | margin-bottom: 1em;
331 | margin-top: 0;
332 | }
333 |
334 | a {
335 | color: var(--main-hyperlinks-color);
336 | }
337 |
338 | a:hover {
339 | color: #13B9FD;
340 | }
341 |
342 | pre.prettyprint {
343 | font-family: 'Roboto Mono', Menlo, monospace;
344 | color: black;
345 | border-radius: 0;
346 | font-size: 15px;
347 | word-wrap: normal;
348 | line-height: 1.4;
349 | border: 0;
350 | margin: 16px 0 16px 0;
351 | padding: 8px;
352 | }
353 |
354 | pre code {
355 | white-space: pre;
356 | word-wrap: initial;
357 | font-size: 100%
358 | }
359 |
360 | .fixed {
361 | white-space: pre;
362 | }
363 |
364 | pre {
365 | border: 1px solid #ddd;
366 | background-color: #eee;
367 | font-size: 14px;
368 | }
369 |
370 | code {
371 | font-family: 'Roboto Mono', Menlo, monospace;
372 | color: inherit;
373 | padding: 0.2em 0.4em;
374 | font-size: 85%;
375 | background-color: rgba(27,31,35,0.05);
376 | border-radius: 3px;
377 | }
378 |
379 | @media(max-width: 840px) {
380 | nav .container {
381 | width: 100%
382 | }
383 |
384 | h1 {
385 | font-size: 24px;
386 | }
387 |
388 | pre {
389 | margin: 16px 0;
390 | }
391 | }
392 |
393 | header h1 {
394 | font-weight: 400;
395 | margin-bottom: 16px;
396 | }
397 |
398 | header a,
399 | header p,
400 | header li {
401 | color: #0175C2;
402 | }
403 |
404 | header a:hover {
405 | color: #0175C2;
406 | }
407 |
408 | header h1 .kind {
409 | color: #555;
410 | }
411 |
412 | dt {
413 | font-weight: normal;
414 | }
415 |
416 | dd {
417 | color: var(--main-text-color);
418 | margin-bottom: 1em;
419 | margin-left: 0;
420 | }
421 |
422 | dd.callable, dd.constant, dd.property {
423 | margin-bottom: 24px;
424 | }
425 |
426 | dd p {
427 | overflow-x: hidden;
428 | text-overflow: ellipsis;
429 | margin-bottom: 0;
430 | }
431 |
432 | /* Enum values do not have their own pages; their full docs are presented on the
433 | * enum class's page. */
434 | dt.constant + dd p {
435 | margin-bottom: 1em;
436 | }
437 |
438 | /* indents wrapped lines */
439 | section.summary dt {
440 | margin-left: 24px;
441 | text-indent: -24px;
442 | }
443 |
444 | .dl-horizontal dd {
445 | margin-left: initial;
446 | }
447 |
448 | dl.dl-horizontal dt {
449 | font-style: normal;
450 | text-align: left;
451 | color: #727272;
452 | margin-right: 20px;
453 | width: initial;
454 | }
455 |
456 | dt .name {
457 | font-weight: 500;
458 | }
459 |
460 | dl dt.callable .name {
461 | float: none;
462 | width: auto;
463 | }
464 |
465 | .type-parameter {
466 | white-space: nowrap;
467 | }
468 |
469 | .multi-line-signature .type-parameter .parameter {
470 | margin-left: 0;
471 | display: unset;
472 | }
473 |
474 | .parameter-list {
475 | display: table-cell;
476 | margin-left: 10px;
477 | list-style-type: none;
478 | padding-inline-start: unset;
479 | }
480 |
481 | .signature {
482 | color: var(--main-text-color);
483 | }
484 |
485 | .signature a {
486 | color: var(--main-hyperlinks-color);
487 | }
488 |
489 | .optional {
490 | font-style: italic;
491 | }
492 |
493 | .undocumented {
494 | font-style: italic;
495 | }
496 |
497 | .is-const {
498 | font-style: italic;
499 | }
500 |
501 | .deprecated {
502 | text-decoration: line-through;
503 | }
504 |
505 | .category.linked {
506 | font-weight: bold;
507 | opacity: 1;
508 | }
509 |
510 | /* Colors for category based on categoryOrder in dartdoc_options.config. */
511 | .category.cp-0 {
512 | background-color: #54b7c4
513 | }
514 |
515 | .category.cp-1 {
516 | background-color: #54c47f
517 | }
518 |
519 | .category.cp-2 {
520 | background-color: #c4c254
521 | }
522 |
523 | .category.cp-3 {
524 | background-color: #c49f54
525 | }
526 |
527 | .category.cp-4 {
528 | background-color: #c45465
529 | }
530 |
531 | .category.cp-5 {
532 | background-color: #c454c4
533 | }
534 |
535 | .category a {
536 | color: white;
537 | }
538 |
539 | .category {
540 | padding: 2px 4px;
541 | font-size: 12px;
542 | border-radius: 4px;
543 | background-color: #999;
544 | text-transform: uppercase;
545 | color: white;
546 | opacity: .5;
547 | }
548 |
549 | h1 .category {
550 | vertical-align: middle;
551 | }
552 |
553 | /* The badge under a declaration for things like "const", "read-only", etc. and for the badges inline like Null safety*/
554 | /* See https://github.com/dart-lang/dartdoc/blob/master/lib/src/model/feature.dart */
555 | .feature {
556 | display: inline-block;
557 | background: var(--main-bg-color);
558 | border: 1px solid var(--main-hyperlinks-color);
559 | border-radius: 20px;
560 | color: var(--main-hyperlinks-color);
561 |
562 | font-size: 12px;
563 | padding: 1px 6px;
564 | margin: 0 8px 0 0;
565 | }
566 |
567 | a.feature:hover {
568 | border-color: #13B9FD;
569 | }
570 |
571 | h1 .feature {
572 | vertical-align: middle;
573 | }
574 |
575 | .source-link {
576 | padding: 18px 4px;
577 | font-size: 18px;
578 | vertical-align: middle;
579 | }
580 |
581 | @media (max-width: 840px) {
582 | .source-link {
583 | padding: 7px 2px;
584 | font-size: 10px;
585 | }
586 | }
587 |
588 | #external-links {
589 | float: right;
590 | }
591 |
592 | .btn-group {
593 | position: relative;
594 | display: inline-flex;
595 | vertical-align: middle;
596 | }
597 |
598 | footer {
599 | color: #fff;
600 | background-color: var(--main-footer-background);
601 | width: 100%;
602 | }
603 |
604 | footer p {
605 | margin: 0;
606 | }
607 |
608 | footer .no-break {
609 | white-space: nowrap;
610 | }
611 |
612 | footer .container {
613 | padding-left: 0;
614 | padding-right: 0;
615 | }
616 |
617 | footer a, footer a:hover {
618 | color: #fff;
619 | }
620 |
621 | .markdown.desc {
622 | max-width: 700px;
623 | }
624 |
625 | .markdown h1 {
626 | font-size: 24px;
627 | margin-bottom: 8px;
628 | }
629 |
630 | .markdown h2 {
631 | font-size: 20px;
632 | margin-top: 24px;
633 | margin-bottom: 8px;
634 | }
635 |
636 | .markdown h3 {
637 | font-size: 18px;
638 | margin-bottom: 8px;
639 | color: var(--main-text-color);
640 | }
641 |
642 | .markdown h4 {
643 | font-size: 16px;
644 | margin-bottom: 0;
645 | }
646 |
647 | .markdown li p {
648 | margin: 0;
649 | }
650 |
651 | table {
652 | margin-bottom: 1em;
653 | }
654 |
655 | table,
656 | th,
657 | td {
658 | border: 1px solid lightgrey;
659 | border-collapse: collapse;
660 | }
661 |
662 | th,
663 | td {
664 | padding: 8px;
665 | }
666 |
667 | .gt-separated {
668 | list-style: none;
669 | padding: 0;
670 | margin: 0;
671 | }
672 |
673 | .gt-separated li {
674 | display: inline-block;
675 | }
676 |
677 | .gt-separated li:before {
678 | background-image: url("data:image/svg+xml;utf8,");
679 | background-position: center;
680 | content: "\00a0";
681 | margin: 0 6px 0 4px;
682 | padding: 0 3px 0 0;
683 | }
684 |
685 | .gt-separated.dark li:before {
686 | background-image: url("data:image/svg+xml;utf8,");
687 | }
688 |
689 | .gt-separated li:first-child:before {
690 | background-image: none;
691 | content: "";
692 | margin: 0;
693 | padding: 0;
694 | }
695 |
696 | .multi-line-signature {
697 | font-size: 17px;
698 | color: #727272;
699 | }
700 |
701 | .multi-line-signature .parameter {
702 | margin-left: 24px;
703 | display: block;
704 | }
705 |
706 | .breadcrumbs {
707 | padding: 0;
708 | margin: 8px 0 8px 0;
709 | white-space: nowrap;
710 | line-height: 1;
711 | }
712 |
713 | @media screen and (min-width: 840px) {
714 | nav ol.breadcrumbs {
715 | float: left;
716 | }
717 | }
718 |
719 | @media screen and (max-width: 840px) {
720 | .breadcrumbs {
721 | margin: 0 0 24px 0;
722 | overflow-x: hidden;
723 | }
724 | }
725 |
726 | .breadcrumbs .gt-separated .dark .hidden-xs li+li:before {
727 | color: var(--main-h-text);
728 | }
729 |
730 | ol.breadcrumbs li a {
731 | color: var(--main-hyperlinks-color);
732 | }
733 |
734 | .self-crumb {
735 | color: var(--main-h-text);
736 | }
737 |
738 | .self-name {
739 | color: #555;
740 | display: none;
741 | }
742 |
743 | .annotation-list {
744 | list-style: none;
745 | padding: 0;
746 | display: inline;
747 | }
748 |
749 | .comma-separated {
750 | list-style: none;
751 | padding: 0;
752 | display: inline;
753 | }
754 |
755 | .comma-separated li {
756 | display: inline;
757 | }
758 |
759 | .comma-separated li:after {
760 | content: ", ";
761 | }
762 |
763 | .comma-separated li:last-child:after {
764 | content: "";
765 | }
766 |
767 | .end-with-period li:last-child:after {
768 | content: ".";
769 | }
770 |
771 | .container > section:first-child {
772 | border: 0;
773 | }
774 |
775 | .constructor-modifier {
776 | font-style: italic;
777 | }
778 |
779 | section.multi-line-signature div.parameters {
780 | margin-left: 24px;
781 | }
782 |
783 | /* sidebar styles */
784 |
785 | .sidebar ol {
786 | list-style: none;
787 | line-height: 22px;
788 | margin-top: 0;
789 | margin-bottom: 0;
790 | padding: 0 0 15px 0;
791 | }
792 |
793 | .sidebar h5 a,
794 | .sidebar h5 a:hover {
795 | color: var(--main-sidebar-color);
796 | }
797 |
798 | .sidebar h5,
799 | .sidebar ol li {
800 | text-overflow: ellipsis;
801 | overflow: hidden;
802 | padding: 3px 0 3px 3px;
803 | }
804 |
805 | .sidebar h5 {
806 | color: var(--main-sidebar-color);
807 | font-size: 18px;
808 | margin: 0 0 22px 0;
809 | padding-top: 0;
810 | }
811 |
812 | .sidebar ol li.section-title {
813 | font-size: 18px;
814 | font-weight: normal;
815 | text-transform: uppercase;
816 | padding-top: 25px;
817 | }
818 |
819 | .sidebar ol li.section-subtitle a {
820 | color: inherit;
821 | }
822 |
823 | .sidebar ol li.section-subtitle {
824 | font-weight: 400;
825 | text-transform: uppercase;
826 | }
827 |
828 | .sidebar ol li.section-subitem {
829 | margin-left: 12px;
830 | }
831 |
832 | .sidebar ol li:first-child {
833 | padding-top: 3px;
834 | margin-top: 0;
835 | }
836 |
837 | button {
838 | padding: 0;
839 | }
840 |
841 | #sidenav-left-toggle {
842 | display: none;
843 | vertical-align: text-bottom;
844 | padding: 0;
845 | color: var(--main-icon-color);
846 | user-select: none;
847 | cursor: pointer;
848 | }
849 |
850 | /* left-nav disappears, and can transition in from the left */
851 | @media screen and (max-width:840px) {
852 | #sidenav-left-toggle {
853 | display: inline;
854 | width: 24px;
855 | height: 24px;
856 | border: none;
857 | margin-right: 24px;
858 | margin-left: 24px;
859 | font-size: 24px;
860 | }
861 |
862 | #overlay-under-drawer.active {
863 | opacity: 0.4;
864 | height: 100%;
865 | z-index: 1999;
866 | position: fixed;
867 | top: 0;
868 | left: 0;
869 | right: 0;
870 | bottom: 0;
871 | background-color: black;
872 | display: block;
873 | }
874 |
875 | .sidebar-offcanvas-left {
876 | left: -100%;
877 | position: fixed;
878 | -webkit-transition:all .25s ease-out;
879 | -o-transition:all .25s ease-out;
880 | transition:all .25s ease-out;
881 | z-index: 2000;
882 | top: 0;
883 | width: 280px; /* works all the way down to an iphone 4 */
884 | height: 90%;
885 | background-color: var(--main-bg-color);
886 | overflow-y: scroll; /* TODO: how to hide scroll bars? */
887 | padding: 10px;
888 | margin: 10px 10px;
889 | box-shadow: 5px 5px 5px 5px #444444;
890 | }
891 |
892 | ol#sidebar-nav {
893 | font-size: 18px;
894 | white-space: pre-line;
895 | }
896 |
897 | .sidebar-offcanvas-left.active {
898 | left: 0; /* this animates our drawer into the page */
899 | }
900 |
901 | .self-name {
902 | display: inline-block;
903 | color: var(--main-hyperlinks-color);
904 | }
905 | }
906 |
907 | .sidebar-offcanvas-left h5 {
908 | margin-bottom: 10px;
909 | }
910 |
911 | .sidebar-offcanvas-left h5:last-of-type {
912 | border: 0;
913 | margin-bottom: 25px;
914 | }
915 |
916 | /* the right nav disappears out of view when the window shrinks */
917 | @media screen and (max-width: 992px) {
918 | .sidebar-offcanvas-right {
919 | display: none;
920 | }
921 | }
922 |
923 | #overlay-under-drawer {
924 | display: none;
925 | }
926 |
927 | /* find-as-you-type search box */
928 |
929 | .form-control {
930 | border-radius: 0;
931 | border: 0;
932 | }
933 |
934 | @media screen and (max-width: 840px) {
935 | form.search {
936 | display: none;
937 | }
938 | }
939 |
940 | .typeahead {
941 | width: 200px;
942 | padding: 2px 7px 1px 7px;
943 | line-height: 20px;
944 | outline: none;
945 | }
946 |
947 | .tt-wrapper {
948 | position: relative;
949 | display: inline-block;
950 | }
951 |
952 | .tt-input {
953 | position: relative;
954 | vertical-align: top;
955 | }
956 |
957 | .navbar-right .tt-menu {
958 | right: 0;
959 | left: inherit !important;
960 | width: 540px;
961 | max-height: 280px;
962 | overflow-y: scroll;
963 | }
964 |
965 | .navbar-right {
966 | padding-right: 60px;
967 | }
968 |
969 | .tt-menu {
970 | position: absolute;
971 | top: 100%;
972 | left: 0;
973 | z-index: 100;
974 | font-size: 14px;
975 | margin: 0;
976 | background-color: var(--main-bg-color);
977 | border: 1px solid var(--main-header-color);
978 | -webkit-box-shadow: 0 5px 10px rgba(0,0,0,.2);
979 | -moz-box-shadow: 0 5px 10px rgba(0,0,0,.2);
980 | box-shadow: 0 5px 10px rgba(0,0,0,.2);
981 | }
982 |
983 |
984 | .typeahead {
985 | padding: 17px 17px 17px 50px;
986 | width: 422px;
987 | height: 20px;
988 | font-size: 13px;
989 | background-image: url("./search.svg");
990 | background-repeat: no-repeat;
991 | background-position: 4%;
992 | outline: 0;
993 | background-size: 20px;
994 | filter: var(--main-number-filter);
995 | -webkit-filter: var(--main-number-filter);
996 | }
997 |
998 | .search-summary {
999 | margin-bottom: 10px;
1000 | }
1001 |
1002 | a.tt-container {
1003 | font-size: 16px;
1004 | color: var(--main-hyperlinks-color);
1005 | }
1006 |
1007 | .enter-search-message {
1008 | position: -webkit-sticky;
1009 | position: sticky;
1010 | top: 0;
1011 | background-color: #AAA;
1012 | padding: 0;
1013 | font-size: 14px;
1014 | margin: 0;
1015 | clear: both;
1016 | text-align: center;
1017 | color: black;
1018 | }
1019 |
1020 | .tt-suggestion:hover {
1021 | cursor: pointer;
1022 | color: #fff;
1023 | background-color: #0097cf;
1024 | }
1025 |
1026 | .tt-suggestion:hover .search-from-lib {
1027 | color: #ddd;
1028 | }
1029 |
1030 | .tt-suggestion.tt-cursor {
1031 | color: #fff;
1032 | background-color: #0097cf;
1033 | }
1034 |
1035 | .tt-suggestion.tt-cursor .search-from-lib {
1036 | color: #ddd;
1037 | }
1038 |
1039 | .tt-suggestion p {
1040 | margin: 0;
1041 | }
1042 |
1043 | .tt-container {
1044 | font-size: 14px;
1045 | margin-bottom: 0;
1046 | margin-top: 15px;
1047 | }
1048 |
1049 | .tt-container-text {
1050 | color: var(--main-text-color);
1051 | }
1052 |
1053 |
1054 | /* Search results formatting for mini results below search bar. */
1055 |
1056 | .tt-search-results .tt-container {
1057 | margin-top: 5px;
1058 | margin-bottom: 5px;
1059 | }
1060 |
1061 | /* Do not show the container as a section. */
1062 | .tt-search-results .tt-container-text {
1063 | display: none
1064 | }
1065 |
1066 | /* An inline style. */
1067 | .tt-search-results .tt-suggestion {
1068 | color: var(--main-text-color);
1069 | margin-top: 5px;
1070 | overflow: hidden;
1071 | padding-left: 10px;
1072 | padding-right: 10px;
1073 | text-overflow: ellipsis;
1074 | white-space: nowrap;
1075 | }
1076 |
1077 | .tt-search-results .tt-suggestion-title {
1078 | font-size: 14px;
1079 | padding-right: 5px;
1080 | }
1081 |
1082 | .tt-search-results .tt-suggestion-container {
1083 | color: var(--main-keyword-color);
1084 | font-size: 14px;
1085 | font-style: italic;
1086 | padding-right: 5px;
1087 | }
1088 |
1089 | .tt-search-results .one-line-description {
1090 | color: var(--main-keyword-color);
1091 | display: inline;
1092 | margin-left: 0;
1093 | }
1094 |
1095 |
1096 | .tt-search-results .one-line-description::before {
1097 | content: open-quote;
1098 | }
1099 |
1100 | .tt-search-results .one-line-description::after {
1101 | content: close-quote;
1102 | }
1103 |
1104 | /* Search results formatting for `search.html`. */
1105 |
1106 | /* A block style. */
1107 | #dartdoc-main-content .tt-suggestion {
1108 | color: var(--main-text-color);
1109 | margin-top: 5px;
1110 | margin-bottom: 10px;
1111 | border-style: solid;
1112 | border-color: lightgrey;
1113 | border-width: 0.5px;
1114 | }
1115 |
1116 | #dartdoc-main-content .tt-suggestion-title {
1117 | display: block;
1118 | font-weight: 500;
1119 | margin: 4px 10px 0;
1120 | }
1121 |
1122 | #dartdoc-main-content .one-line-description {
1123 | display: block;
1124 | margin: 2px 10px 3px;
1125 | }
1126 |
1127 | /* Do not show a result's container. */
1128 | #dartdoc-main-content .tt-suggestion-container {
1129 | display: none;
1130 | }
1131 |
1132 | @media screen and (max-width: 840px) {
1133 | .typeahead {
1134 | padding: 17px 17px 17px 33px;
1135 | width: 240px;
1136 | height: 17px;
1137 | border: 1px solid #f5f5f5;
1138 | background-position: 3%;
1139 | margin: 10px 10px 10px 9px;
1140 | }
1141 |
1142 | header {
1143 | padding-left: 0;
1144 | }
1145 | }
1146 |
1147 | @media screen and (max-width: 320px) {
1148 | #sidenav-left-toggle {
1149 | margin-right: 10px;
1150 | margin-left: 20px;
1151 | }
1152 |
1153 | .self-name {
1154 | margin-right: 10px;
1155 | }
1156 | }
1157 |
1158 | ::placeholder {
1159 | filter: brightness(0.85);
1160 | }
1161 |
1162 | .search-body {
1163 | border: 1px solid #7f7f7f;
1164 | max-width: 400px;
1165 | box-shadow: 3px 3px 5px rgba(0,0,0,0.1);
1166 | }
1167 |
1168 | section#setter {
1169 | border-top: 1px solid #ddd;
1170 | padding-top: 36px;
1171 | }
1172 |
1173 | li.inherited a {
1174 | opacity: 0.65;
1175 | font-style: italic;
1176 | }
1177 |
1178 | #instance-methods dt.inherited .name,
1179 | #instance-properties dt.inherited .name,
1180 | #operators dt.inherited .name {
1181 | font-weight: 400;
1182 | font-style: italic;
1183 | }
1184 |
1185 | #instance-methods dt.inherited .signature,
1186 | #instance-properties dt.inherited .signature,
1187 | #operators dt.inherited .signature {
1188 | font-weight: 400;
1189 | }
1190 |
1191 | @media print {
1192 | .subnav, .sidebar {
1193 | display: none;
1194 | }
1195 |
1196 | a[href]:after {
1197 | content: "" !important;
1198 | }
1199 | }
--------------------------------------------------------------------------------