Critcl wrapper for Mac OS X Authorization services, only the
AuthorizationExecuteWithPrivileges() API for now, c.f. [
1] for details.
Part of
CarbonCritLib:
http://rutherglen.ics.mq.edu.au/~steffen/tcltk/carboncritlib/tclAuthorization.tcl
[ DAS 06/10/07 ]#!/bin/sh
# #######################################################################
#
# tclAuthorization.tcl
#
# Critcl wrapper for Mac OS X Authorization services:
# - AuthorizationExecuteWithPrivileges() only for now
#
# Process this file with 'critcl -pkg' to build a loadable package (or
# simply source this file if [package require critcl] and a compiler
# are available at deployment).
#
#
# Author: Daniel A. Steffen
# E-mail: <[email protected]>
# mail: Mathematics Departement
# Macquarie University NSW 2109 Australia
# www: <http://www.maths.mq.edu.au/~steffen/>
#
# RCS: @(#) $Id$
#
# BSD License: c.f. <http://www.opensource.org/licenses/bsd-license>
#
# Copyright (c) 2005-2007, Daniel A. Steffen <[email protected]>
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or
# without modification, are permitted provided that the following
# conditions are met:
#
# * Redistributions of source code must retain the above
# copyright notice, this list of conditions and the
# following disclaimer.
#
# * Redistributions in binary form must reproduce the above
# copyright notice, this list of conditions and the following
# disclaimer in the documentation and/or other materials
# provided with the distribution.
#
# * Neither the name of Macquarie University nor the names of its
# contributors may be used to endorse or promote products derived
# from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MACQUARIE
# UNIVERSITY OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
# TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
# USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
# DAMAGE.
#
# #######################################################################
# \
exec critcl -pkg "$0" "$@"
package require critcl
if {![::critcl::compiling]} {error "No compiler found"}
#---------------------------------------------------------------------------------------------------
package provide tclAuthorization 1.0
namespace eval tclAuthorization {
if {[llength [info commands ::critcl::framework]]} {
::critcl::framework Security
} else {
lappend ::critcl::v::compile -framework Security
}
::critcl::ccode {
#include <stdio.h>
#include <unistd.h>
#include <Security/Authorization.h>
#include <Security/AuthorizationTags.h>
typedef struct {
OSStatus code;
const char *name;
} AuthErrId;
static AuthErrId authErrIds[] = {
{ errAuthorizationSuccess,
"AuthorizationSuccess: The operation completed successfully." },
{ errAuthorizationInvalidSet,
"AuthorizationInvalidSet: The set parameter is invalid." },
{ errAuthorizationInvalidRef,
"AuthorizationInvalidRef: The authorization parameter is invalid." },
{ errAuthorizationInvalidTag,
"AuthorizationInvalidTag: The tag parameter is invalid." },
{ errAuthorizationInvalidPointer,
"AuthorizationInvalidPointer: The authorizedRights parameter is invalid." },
{ errAuthorizationDenied,
"AuthorizationDenied: The authorization was denied." },
{ errAuthorizationCanceled,
"AuthorizationCanceled: The authorization was cancelled by the user." },
{ errAuthorizationInteractionNotAllowed,
"AuthorizationInteractionNotAllowed: The authorization was denied since no user interaction was possible." },
{ errAuthorizationInternal,
"AuthorizationInternal: something else went wrong" },
{ errAuthorizationExternalizeNotAllowed,
"AuthorizationExternalizeNotAllowed: authorization externalization denied" },
{ errAuthorizationInternalizeNotAllowed,
"AuthorizationInternalizeNotAllowed: authorization internalization denied" },
{ errAuthorizationInvalidFlags,
"AuthorizationInvalidFlags: invalid option flag(s)" },
{ errAuthorizationToolExecuteFailure,
"AuthorizationToolExecuteFailure: cannot execute privileged tool" },
{ errAuthorizationToolEnvironmentError,
"AuthorizationToolEnvironmentError: privileged tool environment error" },
{ errAuthorizationBadAddress,
"AuthorizationBadAddress: invalid socket address requested" },
{ 0, NULL }
};
static const char *AuthErrTxt(OSStatus status) {
AuthErrId *errId = &authErrIds[0];
while (errId->name && errId->code != status) { errId++; }
return errId->name;
}
}
#---------------------------------------------------------------------------------------------------
#
# tclAuthorization::executeWithPrivileges /path/to/executable ?arg ...?
#
# this command takes an absolute path to an executable along with optional arguments for it,
# and runs that executable with an effective user id of root, after presenting a standard
# Mac OS X authorization dialog (whose prompt shows the given executable and arguments).
#
# If sucessful, the command returns a channel connected to stdin and stdout of the
# executable (stderr is unavailable). That channel needs be closed manually once the
# executable has exited or is no longer needed.
#
#---------------------------------------------------------------------------------------------------
::critcl::ccommand executeWithPrivileges {ClientData interp objc objv} {
int i, result = TCL_ERROR;
Tcl_DString ds;
Tcl_Obj *pathPtr = NULL;
const char *myPathToTool;
char** myArguments = NULL;
FILE *myCommunicationsPipe;
Tcl_Channel chan;
OSStatus myStatus;
AuthorizationItem myAuthorizationExecuteRight = {kAuthorizationRightExecute, 0, NULL, 0};
AuthorizationRights myAuthorizationRights = {1, &myAuthorizationExecuteRight};
AuthorizationItem myAuthorizationPrompt = {kAuthorizationEnvironmentPrompt, 0, NULL, 0};
AuthorizationEnvironment myAuthorizationEnvironment = {1, &myAuthorizationPrompt};
AuthorizationRef myAuthorizationRef = NULL;
while (1) {
Tcl_DStringInit(&ds);
if (objc < 2) {
Tcl_WrongNumArgs(interp, 1, objv, "executable ?arg...?");
break;
}
pathPtr = Tcl_FSGetNormalizedPath(interp, objv[1]);
if (!pathPtr) {
Tcl_AppendResult(interp, "could not normalize path to executable \"",
Tcl_GetString(objv[1]), "\"", NULL);
break;
}
Tcl_IncrRefCount(pathPtr);
if (Tcl_FSAccess(pathPtr, X_OK)) {
Tcl_AppendResult(interp, "command \"", Tcl_GetString(objv[1]),
"\" is not executable: ", Tcl_PosixError(interp), NULL);
break;
}
myPathToTool = Tcl_FSGetNativePath(pathPtr);
if (!myPathToTool) {
Tcl_AppendResult(interp, "could not get native path to executable \"",
Tcl_GetString(objv[1]), "\": ", Tcl_PosixError(interp), NULL);
break;
}
Tcl_DStringAppend(&ds, "Authorize execution of command\n\t", -1);
Tcl_DStringAppendElement(&ds, myPathToTool);
if (objc > 2) {
int n = objc - 2;
myArguments = (char**) ckalloc((n + 1) * sizeof(char*));
for (i = 0; i < n; i++) {
myArguments[i] = Tcl_GetString(objv[i+2]);
Tcl_DStringAppendElement(&ds, myArguments[i]);
}
myArguments[i] = NULL;
}
Tcl_DStringAppend(&ds, "\n", 1);
myAuthorizationPrompt.value = (void*) Tcl_DStringValue(&ds);
myAuthorizationPrompt.valueLength = Tcl_DStringLength(&ds);
myAuthorizationExecuteRight.value = (void*) myPathToTool;
myAuthorizationExecuteRight.valueLength = strlen(myPathToTool);
myStatus = AuthorizationCreate(&myAuthorizationRights, &myAuthorizationEnvironment,
kAuthorizationFlagInteractionAllowed | kAuthorizationFlagExtendRights,
&myAuthorizationRef);
if (myStatus != errAuthorizationSuccess) {
Tcl_AppendResult(interp, "could not authorize, ", AuthErrTxt(myStatus), NULL);
break;
}
myStatus = AuthorizationExecuteWithPrivileges(myAuthorizationRef, myPathToTool,
kAuthorizationFlagDefaults, myArguments, &myCommunicationsPipe);
if (myStatus != errAuthorizationSuccess) {
Tcl_AppendResult(interp, "could not execute command, ", AuthErrTxt(myStatus), NULL);
break;
}
chan = Tcl_MakeFileChannel((void*)fileno(myCommunicationsPipe),
TCL_READABLE|TCL_WRITABLE);
if (!chan) {
Tcl_AppendResult(interp, "could not make tcl channel for I/O pipe", NULL);
break;
}
Tcl_RegisterChannel(interp, chan);
Tcl_SetResult(interp, (char*)Tcl_GetChannelName(chan), TCL_VOLATILE);
result = TCL_OK;
break;
}
if(myAuthorizationRef) {
AuthorizationFree(myAuthorizationRef, kAuthorizationFlagDestroyRights);
}
if (pathPtr) {
Tcl_DecrRefCount(pathPtr);
}
if (myArguments) {
ckfree((char*)myArguments);
}
Tcl_DStringFree(&ds);
return result;
}
}
#---------------------------------------------------------------------------------------------------
Category Package 
