google / asset-check Goto Github PK

View Code? Open in Web Editor NEW

22.0 4.0 7.0 19 KB

Check your .well-known/assetlinks.json file on the cli

Home Page: https://developers.google.com/digital-asset-links/v1/getting-started

License: Apache License 2.0

JavaScript 100.00%

asset-check's Introduction

Asset Check

Check your assetlinks.json file for associations, ensuring you're configured correctly.

This is not an official Google product.

Install

Install the node dependencies and link the executable:

npm install
npm link

Usage

If you've linked the package you can use:

asset-check <filename>            # check a file
asset-check <url>                 # check a url

asset-check -u <useragent> <url>  # check a url with a specific useragent
asset-check -d <url>              # (debug mode) check a url

Or in your install directory:

./run.js <filename>             # check a file
./run.js <url>                  # check a url

./run.js -d <useragent> <url>   # check a url with a specific useragent

Examples

> asset-check -d assetlinks.json
instance[1].target: is not exactly one from </WebTarget>,</AndroidTarget>
Errors validating schema

› asset-check https://www.google.com/.well-known/assetlinks.json
URL: https://www.google.com/.well-known/assetlinks.json
# App Links:
## Websites linked:
- www.google.com
## To apps:
- com.google.android.calendar

Tests

npm test

Release History

0.1.0 Initial release

asset-check's People

Contributors

Stargazers

Watchers

Forkers

paul-matthews dbibbos chayev neotim isabella232 ghas-results faezank

asset-check's Issues

add iOS link detection

Able to download apple-app-site-association file and list associated links

Support include statements

Support include statements as valid markup

As described in the following documentation: https://developers.google.com/identity/smartlock-passwords/android/associate-apps-and-sites#example_associate_apps_with_multiple_websites

Display the URL of the include file, to enable the developer to check that file too.

Validation should fail if the include statement is mixed with other definitions.

Check domain doesn't include path

Check all site entries don't include a path component to the URL.

Fail validation if the path component is included.

For URLs attempt to check the default location for assetlinks.json

When a URL is submitted, attempt to check the default location of the assetlinks.json file.

E.g. www.example.com => https://www.example.com/.well-known/assetlinks.json

Create a functional test that runs against a large set of known-good asset link files

Create a functional test (so it shouldn't be run by default) that tests a large set of known-good URLs. This would indicate that the tool doesn't generate false negatives when used in the real world.

User-Agent value starts with user-agent again

The value of the default user agent starts with user-agent: which in our case led to some strange problems, because the header looked like User-Agent: user-agent:Mozilla/5.0[...]

Report missing https support for URL

Instead of throwing an "Unhandled 'error' event", report the lack of https connection gracefully.

Example of error below:

events.js:154
      throw er; // Unhandled 'error' event
      ^

Error: connect ECONNREFUSED 35.202.93.55:443
    at Object.exports._errnoException (util.js:856:11)
    at exports._exceptionWithHostPort (util.js:879:20)
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1062:14)

Check for compatible robots.txt

When the assetlinks.json file is hosted, ensure that the robots.txt file doesn't exclude access to it.

Fail validation if the robot.txt file excludes access to the .well-known/assetlinks.json file.