integra????o – Thiago Mar??al

Adicionando uma p??gina de cadastro de usu??rios (Hotspot) em ASP.NET no Mikrotik

Cada projeto que pego, ?? uma aventura nova a ser encarada! Dessa vez me adentrei no universo de Linux, rede, SSH, infra e tudo o que ?? direito. Quem n??o conhece, a Mikrotik ?? uma empresa de grande refer??ncia no que tange em equipamentos para redes de computadores. Seu principal destaque ?? o RouterOS que ?? sistema operacional que torna o roteador um poderoso gerente de rede. Dentro do Mikrotik (irei me referenciar sempre dessa forma generalizando como um produto), h?? o HotSpot. Com ele pode-se gerenciar quem ir?? autenticar na rede para usar a internet (ou apenas a intranet), banda usada, taxa de transfer??ncia e outras funcionalidades por usu??rio ou de forma geral. Um exemplo de uso desse sistema ?? de quando voc?? vai a uma rede corporativa onde precisa autenticar-se para usar a internet… ?? isso!

Qual ?? o objetivo desse artigo ent??o? A princ??pio ?? apenas obter as p??ginas originais de hotspot do Mikrotik, colocar um redirecionador para uma p??gina externa, criar uma p??gina externa de cadastro de usu??rio (para que possa acessar a rede) e fazer funcionar. N??o ensinarei como configurar ou criar o hotspot. Pela net h?? v??rios tutoriais muito bons sobre o assunto e tamb??m n??o ?? de minha ??rea. Recomendo fortemente o f??rum da Under-Linux que l?? o pessoal manja muito no assunto.

Nesse artigo usei o Mikrotik MKBR100 que ?? bem f??cil de usar: basta plugar o cabo de rede da internet, do servidor e da energia. Pronto!

Para acessar seu SO, deve-se utilizar o Winbox como se fosse um daqueles players de m??quina virtual ou OpenSSH. Vamos l?? colocar a m??o na massa!

Conecte o cabo de rede de seu PC (ou servidor) na porta (interface) ether2 do Mikrotik. Agora conecte outro cabo na ether1 para os outros computadores da rede (ou roteador simples). Porqu?? na ether1? Estou considerando que o hotspot est?? configurado para monitorar essa interface enquanto a ether2 ser?? utilizado para que o servidor de comunique com o aparelho. Seria algo do tipo:

V?? em IP > Address no Mikrotik para que sejam configuradas as interfaces e sejam endere??ados conforme os exemplos abaixo:

ether1: 192.168.88.1
ether2: 192.168.88.2

Somente atrav??s de IP que ser?? poss??vel enviar os arquivos do hotspot. Se ficar conectando, via MAC, pelo Winbox, voc?? ter?? a mensagem de erro: “router has been disconnected” (logo, conecte-se usando a ether2 – 192.168.88.2). E outra coisa ??: se n??o seguir o esquema acima, outros erros voc?? ter??, como:

could not connect to … no response
could not connect to … connection refused

could not connect to … network is unreachable
could not fetch index from … not found

Tudo isso por causa de configura????o apenas! ?? bom deixar o IP do servidor fixo para que possa dar permiss??o de porta, firewall, etc. No caso deixei como 192.168.88.30 (que no caso era minha pr??pria m??quina). Uma dica: ??s vezes d?? um reboot no aparelho!

O pr??ximo passo ?? ativar a porta da API que o Mikrotik disp??e para integra????o com linguagens de programa????o. ?? atrav??s dela que iremos conectar e fazer a comunica????o. S?? que precisamos ativ??-la. V?? em IP > Services e ative a API na porta 8728.

Tamb??m libere, no Firewall, as portas para conex??o tanto do sistema quanto do Winbox (pelo IP), sen??o quando estiver acessando pela p??gina de cadastro, ir?? surgir o erro: “nenhuma conex??o p??de ser feita porque a m??quina de destino as recusou ativamente ..:8728.”.

Para permitir a navega????o e envio de informa????es, adicione as permiss??es no Walled Garden.

Vejam que at?? o momento tudo ?? configura????o e nada de programa????o. Continuemos…

Agora vamos em Files e selecione todos os arquivos da pasta hotspot, arraste para sua ??rea de trabalho que ser?? copiado. Para enviar fa??a o processo inverso… Se estiver acessando pelo IP vai dar certo, sen??o cair?? a conex??o (lembra que disse acima?).

Abra o HTML da p??gina login.html e acione um link para a p??gina de cadastro que ficar?? hospedada no servidor. Adicionei o link <a href=“http://192.168.88.30/mikrotik/cadastro.aspx”>cadastre-se</a> . Customize as demais p??ginas como desejar e as envie de volta. Praticamente terminamos de trabalhar no Mikrotik.

Agora vem o mais simples: criar a p??gina ASP.NET. Voc?? pode utilizar qualquer linguagem de programa????o que possa usar TCP na comunica????o e que a API suporte: PHP, Delphi, C, C++, C#, Flash, Ruby on Rails, Java, Python, VB.NET, etc.

Fa??a o download da classe MK, em C# (eles j?? disp??e de classes prontas para outras linguagens tamb??m), nesse link aqui e adicione no seu projeto. Agora crie um Web Form adicionando os campos que queira trabalhar. No meu exemplo, s?? quis login (username) e senha. Adicione um Button e um m??todo para executar o cadastro do usu??rio conforme exemplo abaixo:

// Autentica????o
MK mikrotik = new MK(“192.168.88.2”);
if (!mikrotik.Login(“admin”, “”))
{
ScriptManager.RegisterStartupScript(Page, typeof(Page), “alert”, “alert(‘Houve um problema de comunica????o com o Hotspot! Por favor, tente mais tarde.’);”, true);
mikrotik.Close();
return;
}

// Requisi????o
mikrotik.Send(“/ip/hotspot/user/add”);
mikrotik.Send(“=name=” + nome.Text);
mikrotik.Send(“=password=” + senha.Text, true);

//Retorno
string retorno = string.Empty;
foreach (string h in mikrotik.Read())
{
if (retorno != string.Empty)
retorno += “, “;
retorno += h;
}

// Fecha objeto
mikrotik.Close();

// Valida????o
if (retorno.ToLower().Contains(“!done=ret=”))
ScriptManager.RegisterStartupScript(Page, typeof(Page), “alert”, “alert(‘Cadastro realizado com sucesso!’); location.href=’http://192.168.88.1/login.html’;”, true);
else if (retorno.ToLower().Contains(“message=failure: already have user with this name for this server”))
ScriptManager.RegisterStartupScript(Page, typeof(Page), “alert”, “alert(‘J?? existe um usu??rio com esse nome!’);”, true);
else
ScriptManager.RegisterStartupScript(Page, typeof(Page), “alert”, “alert(‘Falha no cadastro: “ + retorno + “!’);”, true);

Voc?? poderia n??o s?? fazer o cadastro de usu??rio no hotspot como tamb??m executar qualquer comando (SSH) no Mikrotik. Lembrando que eu atropelei muita coisa a?? no que diz respeito a configura????o do dispositivo na qual disse logo no in??cio que n??o era minha finalidade. Voc??s observaram que a parte de programa????o ?? bem simples do que configura????o… e com certeza ??! Agora nunca ir?? sair de minha cabe??a a palavra Mikrotik Mikrotik Mikrotik Mikrotik Mikrotik … Por favor, qualquer erro ou informa????o adicional me avise!

[]’s

UPDATE: disponibilizei uma implementa????o no post http://thiagomarcal.blogspot.com.br/2016/09/implementacao-do-aspnet-c-com-o.html

Integra????o ASP.NET (C#) com o Google Analytics

Nesse artigo irei demonstrar como fazer consultas no Google Analytics, de um determinado site, para ser usado em c??lculos estat??sticos afim de gerar gr??ficos semelhantes. Ou seja, irei demonstrar como fazer a consulta e retornar os dados. Os gr??ficos e exposi????o dos dados ficar?? ao seu crit??rio. Ao final poder?? ter algo assim:

Primeiramente e ??bvio, ?? preciso dos dados da conta Google como o e-mail e senha para autentica????o. Cada site cadastrado no Analytics tem um ID do Perfil e ele pode ser localizado na seguinte p??gina de Configura????es do Perfil. Atrav??s desse Id ?? que consultamos os dados de um determinado site.

Com esses dados em m??os, vamos ao entendimento da integra????o. O Google disponibilizou um framework que auxilia na consulta e retorno de dados em .NET e ela pode ser baixada no Google GData. Dentro dela cont??m v??rios bin??rios mas precisaremos apenas dos seguintes:

Google.GData.Analytics.dll
Google.GData.Client.dll
Google.GData.Extensions.dll

Adicione-os ao seu projeto. Mas antes de come??ar a programar isso, vamos ao entendimento das consultas realizadas. No link http://code.google.com/intl/pt-BR/apis/analytics/docs/gdata/gdataExplorer.html tem um simulador que ser?? similar ?? consulta feita pela sua aplica????o. J?? no link http://code.google.com/intl/pt-BR/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html cont??m toda as especifica????es necess??rias.
Como n??o gosto de perder tempo e, para muitos pode ser um pouco confuso o seu entendimento logo de cara, vamos fazer uma abstra????o:

ids: ?? o ID do Perfil conforme vimos anteriormente;
dimensions: vamos “acatar” que seja os relacionamentos (linhas) (n??o ?? obrigat??rio);
metrics: vamos “acatar” que seja o que deseja buscar (colunas);
segment: especifica????o do tipo de consulta (n??o ?? obrigat??rio);
filters: ?? o WHERE da consulta (n??o ?? obrigat??rio);
sort: ordena????o (n??o ?? obrigat??rio);
start-date: data de in??cio (formato yyyy-MM-dd);
end-date: data final (formato yyyy-MM-dd);
start-index: serve para paginar dados (como o MySQL usa o LIMIT);
max-result: quantidade m??xima de registros retornados.

Essa ?? a explica????o mais entend??vel poss??vel e que posso passar para voc??s. Logo, antes de botar a m??o na massa, sugiro fazer v??rias simula????es e ver como ?? retornado os objetos. De acordo com a simula????o que fiz, por exemplo, e de acordo com a figura seria a seguinte busca:

“Me retorne todas as cidades, que visitaram meu blog, com suas respectivas quantidades de visitas no per??odo de 03/07/2011 a 17/07/2011 ordenada por cidade. S?? me traga os 50 primeiros registros.”

Ent??o, me seria retornado a seguinte “tabela”:

Ficou claro? Tranquilo, n??? A pior parte j?? passou. Agora, porqu?? escrevi “tabela”… Porque n??o ??! Lembra que abstra??mos para que seja isso. Sabendo de como a API trabalha ent??o bastemos implementar. Vamos l??! Pode-se criar uma classe ou incorporar na mesma p??gina o c??digo. Fica a seu crit??rio!

Adicione os seguintes namespaces:

using Google.Analytics;
using Google.GData.Analytics;
using Google.GData.Client;
using Google.GData.Extensions;

Tamb??m as vari??veis abaixo s??o necess??rias para a devida autentica????o e consulta nas quais descrevem:

// Vari??veis
string user; // Usu??rio da Conta Google Analytics
string pass; // Senha da Conta Google Analytics
string id_tabela; // ID do Perfil

// Inicializa????o
user = “email@gmail.com”;
pass = “senha”;
id_tabela = “ga:30897221”; // Tem que colocar a string “ga” na frete do ID do Perfil

Agora adicione os seguinte m??todos:

/// <summary>
/// Consulta o Analytics
/// </summary>
/// <param name=”query”></param>
private DataFeed ConsultaAnalytics(DataQuery query)
{
AnalyticsService asv = new AnalyticsService(“gaExportAPI_acctSample_v2.0”);
asv.setUserCredentials(user, pass);
String baseUrl = “https://www.google.com/analytics/feeds/data”;
query.Ids = id_tabela;
query.Uri = new Uri(baseUrl);
return asv.Query(query);
}

/// <summary>
/// Retorna o resultado da consulta
/// </summary>
/// <param name=”query”></param>
/// <returns></returns>
private DataTable RetornaTabela(DataQuery query)
{
DataTable resultado = new DataTable();
DataFeed feed = ConsultaAnalytics(query);
if (feed.Entries.Count > 0)
{
// Cria as colunas
DataEntry colunEntry = feed.Entries[0] as DataEntry;
foreach (Dimension colundimension in colunEntry.Dimensions)
resultado.Columns.Add(new DataColumn(colundimension.Name.Substring(3)));
foreach (Metric colunmetric in colunEntry.Metrics)
resultado.Columns.Add(new DataColumn(colunmetric.Name.Substring(3)));

// Insere os dados
foreach (DataEntry singleEntry in feed.Entries)
{
DataRow rw = resultado.NewRow();
foreach (Metric metric in singleEntry.Metrics)
rw[metric.Name.Substring(3)] = metric.Value;
foreach (Dimension dimension in singleEntry.Dimensions)
rw[dimension.Name.Substring(3)] = dimension.Value;
resultado.Rows.Add(rw);
}
}
return resultado;
}

??bvio que essas s??o apenas sugest??es de implementa????es e voc?? podem mudar o quanto achar melhor a depender de sua unidade de neg??cio. Agora vamos fazer aquela consulta:

// Dados da consulta
DataQuery q = new DataQuery();
q.Dimensions = “ga:city”;
q.Metrics = “ga:visits”;
q.GAStartDate = DateTime.Parse(“03/07/2011”).ToString(“yyyy-MM-dd”);
q.GAEndDate = DateTime.Parse(“17/07/2011”).ToString(“yyyy-MM-dd”);
q.Sort = “ga:city“;
q.NumberToRetrieve = 50;

// Resultado
DataTable resultado = RetornaTabela(q);

Pronto! Ir?? me retornar um DataTable com aquela tabela de dados. Basicamente todas aquelas informa????es que voc?? v?? no Analytics s??o vindas em formato tabela e que, posteriormente, s??o feitos tratamentos e c??lculos sobre eles. Como disse no in??cio do artigo, agora basta usar a tabela de dados conforme desejar…
Espero que tenham gostado depois de um tempo sem postar nada…