ily.li/views/auth-tokens.njk

{% extends 'layouts/base.njk' %}

{% set title = app.name + ' - Auth tokens' %}

{% block body %}
<div class="container">
    <section class="panel">
        <h2><i data-feather="key"></i> Auth tokens</h2>
        <form action="{{ route('generate-token') }}" method="POST">
            {{ macros.csrf(getCsrfToken) }}

            <button type="submit"><i data-feather="plus"></i> Generate a new token</button>
        </form>

        <table class="data-table">
            <thead>
            <tr>
                <th>#</th>
                <th class="table-col-grow">Secret</th>
                <th>Created at</th>
                <th>Last used at</th>
                <th>Actions</th>
            </tr>
            </thead>

            <tbody>
            {% for token in auth_tokens %}
                <tr>
                    <td>{{ token.id }}</td>
                    <td>
                        <div class="copyable-text">
                            <div class="content">{{ token.secret }}</div>
                            <button class="copy-button"><i data-feather="copy"></i></button>
                        </div>
                    </td>
                    <td>{{ token.created_at.toISOString() }}</td>
                    <td>{{ token.used_at.toISOString() }}</td>
                    <td class="actions">
                        <form action="{{ route('revoke-token', token.id) }}" method="POST">
                            <button class="button danger"><i data-feather="trash"></i> <span class="tip">Revoke</span></button>
                            {{ macros.csrf(getCsrfToken) }}
                        </form>
                    </td>
                </tr>
            {% endfor %}
            </tbody>
        </table>
    </section>


    <section class="panel">
        <h2><i data-feather="tool"></i> Setup a desktop utility</h2>
        <p>There may be a desktop client at some point. For now, if you're an advanced user, you can setup
            scripts/macros.</p>

        <hr>
        <section>
            <h3>First alternative: sh script (native on linux)</h3>
            <p>If you have the sh shell on your machine (i.e. you are on linux, git bash on windows...) and curl, you can
                download and use these scripts:</p>
            <table class="data-table">
                <thead>
                <tr>
                    <th class="table-col-grow">Name</th>
                    <th>Download link</th>
                </tr>
                </thead>
                <tbody>
                <tr>
                    <td>upload_file.sh</td>
                    <td><a href="{{ route('file-linux-script') }}">Download</a></td>
                </tr>
                <tr>
                    <td>shrink_url.sh</td>
                    <td><a href="{{ route('url-linux-script') }}">Download</a></td>
                </tr>
                </tbody>
            </table>
            <p>You must put a valid auth token (generated in the form at the bottom of this page) in a .ily_token
                file in your home directory (<code>$HOME/.ily_token</code>).</p>
            <p>Examples:</p>
            <pre>upload_file.sh path/to/file</pre>
            <pre>upload_file.sh path/to/file my_very_important_file.png</pre>
            <pre>shrink_url.sh https://eternae.ink/ashpie/ily.li</pre>
            <pre>shrink_url.sh https://eternae.ink/ashpie/ily.li repo</pre>
        </section>

        <hr>

        <section>
            <h3>Second alternative: implement your own client</h3>
            <p>
                To upload the file, you must:
            </p>
            <ul>
                <li>Set the "Authorization" HTTP header to an auth token (generate one with the form below)</li>
                <li>Make a proper file upload request either with the method "POST" on / (auto-generates a short
                    url) or "PUT" (choose the target url you want, alphanum)
                </li>
            </ul>
            <table class="data-table">
                <thead>
                <tr>
                    <th>Field name</th>
                    <th>Description</th>
                    <th>Required?</th>
                    <th>Value(s)</th>
                </tr>
                </thead>

                <tbody>
                <tr>
                    <th colspan="4">File upload</th>
                </tr>
                <tr>
                    <td>type</td>
                    <td>Request type</td>
                    <td>Yes</td>
                    <td>file</td>
                </tr>
                <tr>
                    <td>upload</td>
                    <td>File field</td>
                    <td>Yes</td>
                    <td>The actual file contents</td>
                </tr>
                <tr>
                    <td>ttl</td>
                    <td>How much time (in seconds) to keep the file</td>
                    <td>No</td>
                    <td>0 (never delete), 30 (delete after 30s)</td>
                </tr>
                <tr>
                    <td>url_domain</td>
                    <td>Choose domain name</td>
                    <td>No</td>
                    <td>{{ allowed_domains.join('|') }}</td>
                </tr>

                <tr>
                    <th colspan="4">URL shrink</th>
                </tr>
                <tr>
                    <td>type</td>
                    <td>Request type</td>
                    <td>Yes</td>
                    <td>url</td>
                </tr>
                <tr>
                    <td>target_url</td>
                    <td>Target url</td>
                    <td>Yes</td>
                    <td>A valid URL starting with https:// or http://</td>
                </tr>
                <tr>
                    <td>url_domain</td>
                    <td>Choose domain name</td>
                    <td>No</td>
                    <td>{{ allowed_domains.join('|') }}</td>
                </tr>
                </tbody>
            </table>
            <p>For examples with curl, please download and review the scripts above.</p>
        </section>
    </section>
</div>
{% endblock %}