Sentinel Password Checker API

You can use the API interface to query the first six bytes of the sha1 hash of your password.

For example password secret has sha1 hash hexdigest value of e5e9fa1ba31ecd1ae84f75caaa474f3a663f05f4 and you will strip the first 6 characters, thus e5e9fa.

Schema for API request

A message should look like the following:

{ "msg_type":"request","hash":"e5e9fa" }

Request JSON schema

{
    "type":"object",
    "description": "Api message request",
    "properties": {
        "msg_type": {"enum": ["request"]},
        "hash": {
            "type": "string",
            "pattern": "^[a-z0-9]{6}$"
        }
    },
    "required" : ["hash", "msg_type"],
    "additionalProperties": false
}

You will get either ..."status":"SUCCESS" response, which indicates that we have some entries for the start of your hash. You should compare your full hash against the list we sent you in that case. Eventually, you'll get ..."status":"NO_QUERY" that indicates there is no entry in our database that starts with the sha1 hash stub you provided.

Response JSON schema

{
    "definitions": {
        "sha1": {
            "type": "string",
            "pattern": "^[a-z0-9]{40}$"
        },
        "hash_item": {
            "type": "object",
            "properties": {
                "hash": {"$ref": "#/definitions/sha1"},
                "count": {"type": "integer", "minimum":1},
                "sources": {
                    "type": "array",
                    "items": {
                        "type": "string",
                        "enum" : ["telnet", "smtp", "ftp", "http", "haas"]
                    }
                }
            },
            "required": ["hash", "count", "sources"],
            "additionalProperties": false
        }
    },
    "oneOf": [
        {
            "type":"object",
            "description": "Api message response with data",
            "properties": {
                "msg_type": {"enum": ["response"]},
                "status" : {"enum": ["SUCCESS"]},
                "data": {
                    "type": "array",
                    "items": {"$ref": "#/definitions/hash_item"},
                    "minItems": 1
                },
                "hash": {"$ref": "#/definitions/sha1"}
            },
            "required": ["status", "msg_type", "data"],
            "additionalProperties": false
        },
        {
            "type":"object",
            "description": "Api message response hash not found",
            "properties": {
                "msg_type": {"enum": ["response"]},
                "status" : {"enum": ["NO_QUERY"]}
            },
            "required": ["status", "msg_type"],
            "additionalProperties": false
        },
        {
            "type":"object",
            "description": "Input data validation error",
            "properties": {
                "msg_type": {"enum": ["response"]},
                "status": {"enum": ["VALIDATION_ERROR"]},
                "error": {"type": "string"}
            },
            "required": ["msg_type", "status", "error"],
            "additionalProperties": false
        }
    ]
}

Endpoint:

Send your request using POST method to:

/passcheck/apiv1/

You should than check result hashes with your original hash.