superuser 4.1.0

Detect, verify user who execute Flutter program has superuser role and running with superuser permission with replicated UNIX identification commands.

Superuser detection for Flutter desktop application

Superuser is a special user, who granted as much as possible to access system files for maintenance purpose. Different systems has different names to refer superuser (e.g. root in various UNIX system and Administrator in Windows).

Although pub.dev has numerous of packages to detect superuser, they are designed for Android and some packages added iOS support already. Hence, these package may become bulky because of unnessary callbacks along with detection only.

Instead, superuser package offers superuser detection in Flutter desktop and two replicated identification command from UNIX (whoami and group) for additional verification if necessary.

Limitations

This package only tested using informations given on local machines only. Although it can run in domain joined machine since 4.0.0, only local scope can be extracted that any entities related with Activity Directory or LDAP are omitted.

Implementations

Production

No additional setup needed.

Testing or simulating with mock interface

For testing, MockSuperuser must be binded already before performing widget test:

import 'package:flutter_test/flutter_test.dart';
import 'package:superuser/instance.dart';
import 'package:superuser/mock.dart';

void main() {
    setUpAll(() {
        // Bind mock instance here
        SuperuserInstance.bindInstance(
            MockSuperuser(whoAmI: "reonaw"),
        );
    });
    // Do any testes below
}

If using for debug simulation, mock interface must be binded before runApp:

import 'package:flutter/widgets.dart';
import 'package:superuser/instance.dart';
import 'package:superuser/mock.dart';

void main() {
    SuperuserInstance.bindInstance(
        MockSuperuser(
            whoAmI: "hiderik",
            isSuperuser: true,
            isActivated: true,
        ),
    );

    runApp(const YourApp());
}

To alter string detection staregy, it is possible to achieve by applying matchingFlag:

import 'package:flutter/widgets.dart';
import 'package:superuser/instance.dart';
import 'package:superuser/mock.dart';

void main() {
    // Either `yuunagit` or `YUUNAGIT` can be matched by using `OSString.<=` operation in `whoami`.
    SuperuserInstance.bindInstance(
        MockSuperuser(
            whoAmI: "yuunagit",
            matchingFlag: OSString.MATCH_CAPITAL,
        ),
    );

    runApp(const YourApp());
}

Value of matchingFlag has been mentioned in OSString's constructor method already.

Demo

Demo application of superuser has been available in release page in Windows and Linux application.

These demo animations are for reference only, conditions and contents may be differ without notice.

Open without superuser right

Open with superuser right

License

BSD-3