en-US/about_avmtools.help.txt

TOPIC
    about_avmtools
 
SHORT DESCRIPTION
    Gives an overview over the advanced avmtools topics
 
LONG DESCRIPTION
    Welcome to the avmtools help central.
 
    Checkout the following links for help:
    Wiki: https://github.com/chikenborgir/avmtools/wiki
    License: https://github.com/chikenborgir/avmtools/blob/main/LICENSE
    Website: https://github.com/chikenborgir/avmtools
 
SECOND FACTOR AUTHENTICATION (-Token)
    When two-factor authentication is enabled on the FRITZ!Box, security
    relevant actions answer with UPnP error 866 (second factor required).
    Every state-changing function therefore accepts an optional -Token:
 
        $r = Set-AvmAuthConfig -Url ... -Port ... -Credential ... -NewAction start
        # $r.NewToken contains the token, $r.NewMethods how to confirm
        # (e.g. press a button on the box or dial a DTMF code)
        Get-AvmAuthState -Url ... -Port ... -Credential ... -Token $r.NewToken
        # repeat until NewState is 'authenticated', then
        Set-AvmVoipClient -Url ... -Port ... -Credential ... -Token $r.NewToken ...
 
    The token is sent as <avm:token> in the SOAP header and is ignored by
    actions that do not require it.
 
KEYWORDS
    avm avmtools fritzbox fritz api