원격 접속 자동화 (3): libssh

참고 사이트 : libssh 홈페이지

원격 접속 자동화 (1): rsa 및 dsa key, ssh-agent 사용의 내용에서 확장되는 내용이다.

libssh란 무엇인가 하면, 말 그대로이다. ssh의 여러가지 구현을 라이브러리화 하여 어플리케이션에서 사용할 수 있게 만들어 놓은 것이다. libssh의 홈페이지에 나온 설명을 인용한다.

The ssh library was designed to be used by programmers needing a working SSH implementation by the mean of a library. The complete control of the client is made by the programmer. With libssh, you can remotely execute programs, transfer files, use a secure and transparent tunnel for your remote programs. With its Secure FTP implementation, you can play with remote files easily, without third-party programs others than libcrypto (from openssl).

FROM http://0xbadc0de.be/wiki/libssh:libssh

간단하게 생각하면, 우리가 ssh, scp 커맨드를 사용해서 할 수 있는 모든 것들을 라이브러리로 제공하고, 어플리케이션을 통해 그것을 구현할 수 있게 해주는 것이다.

음 여기까지만 설명하고 자 홈페이지에서 연구해보세요 하기에는 너무 무책임하니, 간단하게 구현된 예제를 설명해보자. 아래 예제는 라이브러리의 테스트를 위해 시험용으로 구현된 코드를 간략화하여, 대략의 함수 호출 흐름만 알아볼 수 있게 편집된 것이다.

void run_copy(char *hostname, char *filename)
{
    SSH_OPTIONS *ssh_opt;
    SSH_SESSION *ssh_sess;
    SFTP_SESSION *sftp_sess;
    SFTP_FILE *sftp_fp;
    PRIVATE_KEY *pk;
    STRING *s;
    int authtype;

    ssh_opt = set_ssh_opt(hostname); // libssh의 option 구조체를 만드는 함수이다.
    ssh_sess = ssh_connect(ssh_opt); // 대상 서버로 연결한다.
    s = publickey_from_file("./pub", &authtype); // authkey file을 사용한 연결을 준비하기 위해, file로부터 public key를 읽어들인다.
    pk = privatekey_from_file(ssh_sess, "./priv", authtype, "iampassphrase"); // file로부터 private key를 읽어들인다.
    ssh_userauth_pubkey(ssh_sess, "root", s, pk); // 읽어들인 public key, private key, 패스워드를 가지고 사용자를 인증한다.
    private_key_free(pk); free(s); // 인증에 사용된 구조체들을 free한다.

    sftp_sess = sftp_new(ssh_sess); // 위에서 생성한 ssh session을 가지고 sftp session을 생성한다.
    fp = fopen(filename, "r"); // 전송을 할 원본 file을 연다.
    sftp_fp = sftp_open(sftp_sess, filename, O_WRONLY | O_CREAT | O_TRUNC, NULL); // 전송받을 원격 file을 연다.

    readlen = fread(readbuf, 1, READBUF_SIZE, fp); // 파일을 읽어서,
    cur_send = sftp_write(sftp_fp, readbuf, readlen); // 쓴다. 이 부분은 의도적으로 구현을 간략화했다.

    sftp_file_close(sftp_fp); // 원격 file을 닫는다.
    fclose(fp); // 원본 file을 닫는다.
    sftp_free(sftp_sess); // sftp session을 닫는다.
    ssh_disconnect(ssh_sess); // ssh session을 닫는다.
}

그러니까, ssh 인증키가 설치된 원격 서버로 별도의 인증 과정 없이 (ssh-agent도 필요없다!) 파일 업로드를 수행하는 예제이다. (물론 소스를 그대로 긁어붙인다고 실행되는 것은 아니다.)

자 위의 예제에서, 2가지에 주목했었다. 결국 보면 같은 문제인데, private key와 public key를 file에서 읽어들인다는 것이다. 별도의 file로 간다면 일단 눈에 보이게 되는 것은 물론이고, 파일을 항상 옮겨야 된다는 불편함이 딱 느껴지지 않는가.
사실 저 key 파일의 내용이란 그저 text로 되어 있는 상황이라 파일을 지정하는 것이 아니라 string으로 입력받을 수 있을 것이라고 생각했지만 libssh상에서는 그런 기능을 지원해주지 않는다. 그래서, 아래와 같이 두가지 함수를 만들었고, key를 string으로 입력이 가능하게 되서 별도의 암호화된 string으로 가공해서 저장하는 것도 가능해졌다.

#include <libssh/priv.h>
#include <openssl/bio.h>
#include <openssl/pem.h>
#include <openssl/err.h>

PRIVATE_KEY *ssh_privatekey_from_string(SSH_SESSION *session, char *stringkey, char *passpharse) throw (Exception)
{
    PRIVATE_KEY *privkey;
    RSA *rsa = NULL;
    BIO *mem = BIO_new_mem_buf(stringkey, -1);

    OpenSSL_add_all_ciphers();

    if (!passpharse) {
        return NULL;
    } else
        rsa = PEM_read_bio_RSAPrivateKey(mem, NULL, NULL, passpharse);

    if (!rsa) {
        BIO_set_close(mem, BIO_NOCLOSE);
        BIO_free(mem);
        return NULL;
    }

    BIO_set_close(mem, BIO_NOCLOSE);
    BIO_free(mem);

    privkey = (PRIVATE_KEY *)malloc(sizeof(PRIVATE_KEY));
    privkey->type = TYPE_RSA; // 사용했던 key가 rsa였다; 파일에서 읽을수도 있었지만 차마 거기까진 처리하지 못한 것을 양해해달라.
    privkey->dsa_priv = NULL;
    privkey->rsa_priv = rsa;

    return privkey;
}

STRING *ssh_publickey_from_string(char *publickey)
{
    BUFFER *buffer;
    STRING *str;

    buffer=base64_to_bin(publickey);
    if(buffer){
        str=string_new(buffer_get_len(buffer));
        string_fill(str,buffer_get(buffer),buffer_get_len(buffer));
        buffer_free(buffer);
        return str;
    } else {
        return NULL; /* invalid file */
    }
}

대략 맛보기를 경험했다면, 본격적으로 사용해보자.

아참. libssh는 2006년 12월 30일에 버젼 0.2로 마지막 릴리즈가 되었다. libssh2 프로젝트가 있는데, 동일한 사람이 제작한 것 같고, 현재 0.15 버젼으로 2007년 6월 25일날 마지막으로 릴리즈 되었다. 한번 테스트 해 보고 싶다면 libssh2를 추천한다.

참고 사이트 : libssh2 홈페이지

2007/07/04 - [작업로그(SE)/쉘 혹은 명령] - 원격 접속 자동화 (1): rsa 및 dsa key, ssh-agent 사용
2007/07/09 - [작업로그(SE)/쉘 혹은 명령] - 원격 접속 자동화 (2): Script Shell: expect
2007/08/07 - [프로그래밍/Library] - 원격 접속 자동화 (3) 추가: libssh2 에서의 *_fromstring
2007/08/09 - [프로그래밍/Library] - 원격 접속 자동화 (3) 추가: libssh2 활용 코드